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1  SCOPE 


1.1  Identification 

This  BBN  Software  Design  Document  describes  the  SINCGARS  radio  simulation 
Computer  Software  Configuration  Item  (CSCI)  for  the  SIMNET  Ml  tank  simulator,  as 
composed  of  Computer  Software  Components  (CSCs)  and  Computer  Software  Units 
(CSUs). 


1.2  System  Overview 

SIMNET  is  an  advanced  research  project  sponsored  by  the  Defense  Advanced  Research 
Projects  Agency  (DARPA)  in  partnership  with  the  United  States  Army.  Currently  in  its 
sixth  year,  the  goal  of  the  program  is  to  develop  the  technology  to  build  a  large-scale 
network  of  interactive  combat  simulators.  This  simulated  battlefield  will  provide,  for  the 
first  time,  an  opportunity  for  fully-manned  platoon-,  company-,  and  batt^ion-level  units 
to  fight  force-on-force  engagements  against  an  opposing  unit  of  similar  composition. 
Furthermore,  it  does  so  in  the  context  of  a  joint,  combined  arms  environment  with  the 
complete  range  of  command  and  control  and  combat  service  support  elements  essential  to 
actual  military  operations.  All  of  the  elements  that  can  affect  the  outcome  of  a  battle  are 
represented  in  this  engagement,  with  victory  likely  to  go  to  that  unit  which  is  able  to  plan, 
orchestrate,  and  execute  its  combined-arms  battle  operations  better  than  its  opponent. 
Whatever  the  outcome,  combat  units  will  benefit  from  this  opportunity  to  practice 
collective,  combined-arms,  joint  war  fighting  skills  at  a  fraction  of  the  cost  of  an 
equivalent  exercise  in  the  field. 

While  simulators  to  date  have  been  shown  to  be  effective  for  training  specific  milita^ 
skills,  their  high  costs  have  made  it  impossible  to  buy  enough  simulators  to  fully  train  the 
force.  Further,  because  of  the  absence  of  a  technology  to  link  them  together,  they  have 
not  been  a  factor  in  collective,  combined-arms,  joint  training.  SIMNET  addresses  both  of 
these  problems  by  aiming  its  research  at  three  high-payoff  areas: 

•  Better  and  cheaper  collective  training  for  combined-arms,  joint  war  fighting  skills 

•  A  testbed  for  doctrine  and  tactics  development  and  assessment  in  a  full  combined- 
arms  joint  setting 

•  A  “simulate  before  you  build”  development  model 

These  payoffs  are  achievable  because  of  recent  breakthroughs  in  several  core 
technologies  that  have  been  applied  to  the  SIMNET  program: 

•  High  speed  microprocessors 

•  Parallel  and  distributed  multiprocessing 

•  Local  area  and  long  haul  networking 

•  Hybrid  depth  buffer  graphics 

•  Special  effects  technology 

•  Unique  fabrication  techniques 
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These  technologies,  applied  in  the  context  of  selective  fidelity  and  rapid  prototyping 
design  philosophies,  have  enabled  SIMNET  development  to  proceed  at  an  unprecedented 
pace,  resulting  in  the  fielding  of  the  first  production  units  at  Fort  Knox,  Kentucky,  just 
three  years  into  the  development  cycle. 

In  addition  to  the  basic  training  applications,  work  is  underway  to  apply  SIMNET 
technology  in  the  area  of  combat  development  to  aid  in  the  definition  and  acquisition  of 
weapon  systems.  This  is  made  possible  because  of  the  low  cost  of  the  simulators,  the 
ease  with  which  they  can  be  modified,  and  the  ability  to  network  them  to  test  the 
employment  of  a  proposed  weapon  system  in  the  tactical  context  in  which  it  will  be  used, 
i.e.,  within  the  context  of  the  combined  arms  setting. 

Work  on  SIMNET  is  being  carried  out  by  co-contractors  Bolt  Beranek  and  Newman  Inc. 
(BBN)  and  Perceptronics,  Inc.  Perceptronics  is  responsible  for  training  analysis,  overall 
system  specification,  and  the  physical  simulators,  and  BBN  is  responsible  for  the  data 
communication  and  computer-based  distributed  simulation  and  the  computer  image 
generation  (CIG)  subsystems.  The  project  is  a  total  team  effort. 

DARPA  is  the  DoD  agency  chartered  with  advancing  the  state  of  the  art  in  military 
technology  by  sponsoring  innovative,  high-risk/high-payoff  research  and  development. 


1.3  Documentation  Overview 

1.3.1  Purpose 

This  document  is  a  representation  of  the  software  system,  and  is  created  to  facilitate 
analysis,  planning,  implementation,  and  decision  making.  It  is  also  used  as  the  primary 
medium  for  communicating  software  design  information. 

The  BBN  Software  Design  Document  is  used  by  the  customer  to  understand  the  detailed 
design  of  the  CSCI. 

1.3.2  Contents 

The  contents  of  this  document  include  the  CSCI's  detailed  design,and  data  structures. 


2  REFERENCED  DOCUMENTS 
There  are  no  applicable  documents. 
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3  PRELIMINARY  DESIGN 

The  following  describes  the  preliminary  design  for  the  SINCGARS  CSCI. 


3.1  CSCI  Overview 

^  The  SINCGARS  radio  simulator  and  radio  interface  unit  (RIU)  simulate  the  RT-1523 
SINCGARS  radio,  either  in  manpack  or  vehicle-borne  configuration.  The  system  can 
reproduce  the  attenuation  of  a  radio  signal  due  to  distance  and  intervening  terrain,  the 
effects  of  transmitter  and  receiver  characteristics,  radio  interference  and  jamming,  and 
detectability  of  emissions  and  source.  They  permit  communication  of  both  voice  and  data  , 
This  paragraph  identifies  and  describes  the  role  of  this  CSCI  within  the  system  to  which 
this  document  applies.  Figure  3.1-1  is  a  system  architecture  diagram  of  the  relationships 
between  this  CSCI  and  the  other  system  CIs.  The  data  being  passed  in  figure  3.1-1  is 
defined  in  the  NAME  CSCI  Data  Dictionary  (Appendix  A).  The  following  identifies  and 
states  the  purpose  of  each  external  interface  of  this  CSCI: 

a.  RIU  Interface.  The  purpose  of  this  interface  is  to  resolve  conflicts  between  voice 
and  data  transmission,  to  queue  requests  for  transmission  and  reception  on  behalf 
of  the  rVIS  simulation,  and  to  handle  overrides  of  queuing  by  a  human  operator. 

It  transmits  and  received  IVIS  simulator  messages  over  the  simulation  Ethernet.  It 
fragments  these  messages  for  transmission  over  the  simulated  radio  channel, 
recomposing  them  on  the  receiving  end. 

b.  SINCGARS  Interface.  The  purpose  of  this  interface  is  to  transmit  and  receive 
voice  and  data  from  other  radios  and  CHS  equipment  in  the  system,  both  real  and 
simulated.  It  provides  support  for  two  different  hardware  interfaces.  One 
interface  allows  connection  of  the  simulated  SINCGARS  radio  via  an 
AUD/DATA  connector  to  CHS  hardware,  specifically,  an  APIU.  The  other 
interface  allows  connection  of  the  simulated  SINCGARS  radio  via  an  RXMT 
(retransmit)  connector  to  a  real  SINCGARS  radio.  Both  connectors  accept 
bitstreams  at  MIL-STD-188  levels. 

Figure  3.1-1  is  a  system  architecture  diagram  of  the  relationships  between  the 
SINCGARS  radio  simulator  and  RIU  and  the  other  system  CIs  of  the  communications 
simulation. 
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□  simulation 

□  CHS  hardware 


Figure  3.1-1  System  Architecture  of  Relationships  Between  SINCGARS  CSCI  and 

the  other  CIs 

3.1.1  CSCI  Architecture 
SINCGARS  provides  the  following  functions: 

•  maintenance  of  signal  attenuation 

•  maintenance  of  vehicle,  transmitter,  and  radio  state  information 

•  simulation  of  signal  reception  and  output 

•  response  to  front  panel  and  keyboard  input 

•  response  to  voice  input  and  simulation  of  signal  transmission 

•  maintenance  of  interface  to  radio  interface  unit  (RIU)  simulation 

•  reporting  of  radio  state  information 

•  checking  and  resetting  hardware  interfaces 
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Figure  3.1-2  illustrates  the  top-level  architecture. 


Figure  3.1. 1-1  SINCGARS  Functions 


3.1.3  System  States  and  Modes 

Not  Applicable 

3.1.3  Memory  and  Processing  Time  Allocation 

Not  Applicable 

3.2  CSCI  Design  Description 

The  following  provides  a  design  description  of  each  CSC  of  this  CSCI. 

When  not  performing  this  interrupt-based  processing,  the  host  process  is  cycling  through 
the  function  described  in  section  3.2.1. 
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Upon  receiving  an  interrupt  marking  the  start  of  a  new  tick,  the  host  process  performs  the 
functions  described  in  sections  3.2.2  to  3.2.8. 


3.2.1  Maintenance  of  signal  attenuation 

The  host  process  maintains  current  estimates  of  signal  attenuation  over  each  path,  from 
every  transmitter  to  each  receiver  it  simulates.  It  recomputes  signal  attenuation  for  the 
paths  between  selected  pairs  of  transmitters  and  receivers. 


3.2.2  Maintenance  of  vehicle,  transmitter,  and  radio  state  information 

The  host  process  maintains  the  state  of  each  radio  it  simulates,  knowledge  of  the  vehicles 
within  which  those  radios  reside,  and  knowledge  of  what  transmitters  exist,  where  those 
transmitters  are  located  in  the  simulated  world,  and  what  each  transmitter’s  characteristics 
are. 


3.2.3  Simulation  of  signal  reception  and  output 

The  host  process  accepts  signal  PDUs  from  the  network  (and  from  the  host’s  own 
transmitters),  simulates  signal  detection  and  capture  by  each  receiver,  and  supplies 
digitized  speech  signals  to  the  voice  I/O  subsystem  for  output. 

It  cliecks  for  and  processes  any  PDUs  received  from  the  network.  For  certain  PDUs  it 
updates  its  knowledge  of  simulated  vehicles,  transmitters,  or  the  state  of  its  own  radios. 
The  contents  of  signal  PDUs  bearing  radio  signal  information  may  be  passed  to  one  or 
more  speech  I/O  channels. 


3.2.4  Response  to  front  panel  and  keyboard  input 

The  host  process  responds  to  inputs  from  radio  front  panel  switches  and  keypads  and 
updates  the  displays  and  internal  radio  state  informati^  i  accordingly; 

Occasionally  it  determines  whether  any  input  has  been  received  from  a  radio  front  panel. 
In  response  to  such  input,  it  determines  that  radio’s  new  state,  and  perhaps  outputs  a  new 
string  of  characters  for  display  on  the  radio’s  front  panel. 

It  checks  for  any  terminal  keyboard  input.  The  terminal  used  to  start  the  host  process 
may  be  used  to  issue  commands  to  it  during  its  execution.  These  commands  are  meant 
primarily  for  debugging. 


3.2.5  Response  to  voice  input  and  simulation  of  signal  transmission 

The  host  process  accepts  digitized  speech  signals  from  the  voice  I/O  subsystem  and  issue; 
signal  and  intercom  PDUs  containing  the  signals; 
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3.2.6  Maintenance  of  intei  face  to  radio  interface  unit  simulation 

The  host  process  supports  an  interface  to  the  radio  interface  unit  (RIU)  simulation  which 
allows  each  simulated  RIU  to  sense  channel  activity,  transmit  data,  and  receive  data. 

It  performs  any  periodic  processing  required  for  the  simulation  of  RIUs. 


3.2.7  Reporting  of  radio  state  information 

The  host  process  periodically  Sc  "s  PDUs  that  repon  the  state  of  its  radio  transmitters  and 
receivers. 


3.2.8  Checking  and  resetting  hardware  interfaces 

The  host  process  checks  that  various  hardware  interfaces  are  responsive  and  resets  those 
that  are  not. 

4  DETAILED  DESIGN 

The  following  provides  detailed  design  information  for  this  CSCI. 

4.1  CSCs 

The  following  figures  describe  the  relationships  between  the  CSUs  of  each  CSC. 


maintenance  of  signal  attenuation 


Figure  4.1-1  Maintenance  of  signal  attenuation 


Figure  4.1-2  Maintenance  of  vehicle,  transmitter  and  radio  state  information 
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Figure  4.1-4  Response  to  front  panel  and  keyboard  input 


response  to  voice  input  and  simulation  of 
signal  transmission 


Figure  4.1-5  Response  to  voice  input  and  simulation  of  signal  transmission 
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Figure  4.1-6  Maintenance  of  interface  to  RIU  simulation 


Figure  4.1-7  Reporting  of  radio  state  information 


Figure  4.1-8  Checking  and  resetting  hardware  interfaces 


4.1.1  Contint  CSU 

The  Contint  CSU  performs  controls  initialization  and  maps  the  front  panel  controls  to 
their  corresponding  functions  (described  in  4.1.2,  “Controls  CSU.” 

4.1.1.1  Contint  CSU  Design  Specification/Constraints 


Function  Definition: 
Call: 


controls_init 

cnt_init  ("/simnet/data/sincgars/radio_dev.def') 


Function  Definition: 
Call: 


controls_simul 
cnt  simul 


Function  Definition: 
Call: 


controls_exit 

cnt_exit 
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Function  Definition: 
Return: 

Function  Definition: 
Call: 

Function  Definition; 
Call: 

Function  Definition: 
Call: 

Function  Definition; 
Call: 

Function  Definition: 
Call; 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
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chan_cue_0 

channel_control(0,CUE) 

chan_maii_0 

channel_control(0,MAN) 
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channel_control(0, 1 ) 
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chan_4_0 

channel_control(0,4) 
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mode_sc_0 
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mode_fh_0 
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modem_fh_m_0 

mode_control(0,FH_M) 
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fctn_control(0,STBY) 

fctn_tst_0 
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fctn_sq_on_0 
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fctn_rem_0 

fctn_control(0,REM) 

fctn_z_fh_0 

fctn_control(0,Z_FH) 
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fctn_control(0,FCTN_OFF) 

comsec_pt_0 
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comm_talk_a_0 

talk_control(0,positionCommander,A) 
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talk_control  (0,positionCommander,B ) 
comm_talk_int_0 

talk_control(0,positionCommander,IMT) 

loader_talk_a_0 
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talk_control(0,positionLoader,B) 

loader_talk_int_0 
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driver  ,talk_a_0 

talk_control(0,positionDriver,A) 

driver_talk_b_0 

talk_control(0,positionDriver,B) 

driver_talk_int_0 

talk_control(0,positionDriver,INT) 

gunner_talk_a_0 

talk_control(0,positionGunner,A) 

gunner_talk_b_0 
talk_control  (0,positionGunner,B ) 

gunner_talk_int_0 

talk_control(0,positionGunner,INT) 

chan_cue_l 

channel_control(  1  ,CUE) 
chan_man_l 
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chan_3_l 

channel_control(  1 ,3) 
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channeLcontrol(l,6) 

mode_sc_l 
mode_control  ( 1 ,  S  C) 

mode_fh_l 
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modem_fh_m_l 
mode_control(  1  ,FH_M) 
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Call:  comsec_control(l,CT) 
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Call:  comsec_control(l,TD) 

Function  Definition:  comsec_rv_l 

Call:  comsec_control(l,RV) 
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Call:  comsec_control(l,COM_Z) 

Function  Definition:  rf_pwr_lo_l 

Call:  pwr_control(l,P\VR_LO) 

Function  Definition:  rf_pwr_m_l 

Call:  pwr_control(l,PWR_M) 

Function  Definition:  rf_pwr_hi_l 

Call:  pwr_control(l,PWR_HI) 

Function  Definition:  rf_p\vr_pa_l 

Call:  pwr_control(l,PWR_PA) 

Function  Definition:  comm_talk_a_l 

Call:  talk_control(l  ,positionCommander,A) 
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channel_control(3,CUE) 
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channel_control(3,MAN) 
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comm_talk_int_4 
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Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 


rf_pwr_pa_5 
p  wr_control  (5  ,P  WR_PA ) 

comm_talk_a_5 

talk_control(5,positionConimander,A) 

comm_talk_b_5 

talk_control(5,positionCoininander,B) 

comm_talk_int_5 

talk_control(5,positionComi'nander,INT) 

loader_talk_a_5 

tal  k_con  trol  (5  .position  Loader,  A ) 
loader_talk_b_5 

talk_control(5,positionLoader,B) 

ioader_talk_int_5 

talk_control(5,positionLoader,INT) 

driver_talk_a_5 

talk_control(5,positionDriver,A) 

driver_talk_b_5 

talk_control(5,positionDriver,B) 

driver_talk_int_5 

talk_control(5,positionDriver,INT) 

gunner_talk_a_5 

talk_control(5,positionGunner,A) 

gunner_talk_b_5 

talk_control(5,positionGunner,B) 

gunner_talk_int_5 

talk_control(5,positionGunner,INT) 

chan_cue_6 

channel_control(6,CUE) 

chan_nian_6 

channel_control(6,MAN) 

chan_l_6 

channel_control(6,l) 

chan_2_6 

channel_control(6,2) 

chan_3_6 

channel_control(6,3) 
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Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 
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chan_4_6 

channel_control(6,4) 

chan_5_6 

channel_control(6,5) 

chan_6_6 

channel_control(6,6) 

mode_sc_6 

mode_control(6,SC) 

mode_fh_6 

mode_control(6,FH) 

modem_fh_m_6 
mode_control  (6,FH_M) 

fctn_stby_6 

fctn_control(6,STBY) 

fctn_tst_6 

fctn_control(6,TST) 

fctn_ld_6 

fctn_control(6,LD) 

fctn_sq_on_6 

fctn_control(6,SQ_ON) 

fctn_sq_off_6 

fctn_control(6,SQ_OFF) 

fctn_rxnt_6 

fctn_control(6,RXMT) 

fctn_rem_6 

fctn_control(6,REM) 

fctn_z_fh_6 
fctn_control(6,7  ’  I) 

fctn_off_6 

fctn_control(6,FCTN_OFF) 

comsec_pt_6 

comsec_control(6,PT) 

comsec_ct_6 

comsec_control(6,CT) 

comsec_td_6 
comsec_con  trol  (6,TD) 
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Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call- 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 


comsec_rv_6 

comsec_control(6,RV) 

comsec_z_6 

comsec_control(6,COM_Z) 

rf_pwr_lo_6 

pwr_control(6,PWR_LO) 

rf_pwr_m_6 

pwr_control(6,PWR_M) 

rf_pwr_hi_6 

pwr_control(6,PWR_HI) 

rf_pwr_pa_6 

pwr_control(6,PWR_PA) 

comm_talk_a_6 

talk_control(6,positionCommander,A) 

comm_talk_b_6 

talk_control(6,positionConimander,B) 

comm_talk_int_6 

talk_control(6,positionCommander,INT) 

loader_talk_a_6 

talk_control(6,positionLoader,A) 

loader_talk_b_6 

talk_con  trol(6  .positionLoader  ,B ) 

loader_talk_int_6 

talk_control(6,positionLx)ader,INT) 

driver_talk_a_6 

talk_control(6,positionDriver,A) 

driver_talk_b_6 

talk_control(6,positionDriver,B) 

driver_talk_int_6 

talk_control(6,positionDriver,INT) 

gunner_talk_a_6 

talk_control(6,positionGunner,A) 

gunner_talk_b_6 

talk_control(6,positionGunner,B) 

gunner_talk_int_6 

talk_control(6,positionGunner,INT) 
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Function  Definition: 
Call; 

Function  Definition: 
Call: 

Function  Definition: 
Call; 

Function  Definition: 
Call; 

Function  Definition: 
Call; 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition; 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call; 

Function  Definition: 
Call: 

Function  Definition: 
Call: 
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chan_cue_7 

channel_control(7,CUE) 

chan_nian_7 

channel_control(7,MAN) 

chan_l_7 

channel_control(7, 1 ) 
chan_2_7 

channel_control(7,2) 

chan_3_7 

channel_control(7,3) 

chan_4_7 

channel_control(7,4) 

chan_5_7 

channel_control(7,5) 

chan_6_7 

channel_control(7,6) 

mode_sc_7 

mode_control(7,SC) 

mode_fh_7 

mode_control(7,FH) 

modem_fh_m_7 

mode_control(7,FH_M) 

fctn_stby_7 

fctn_control(7,STBY) 

fctn_tst_7 

fctn_control(7,TST) 

fctn_ld_7 

fctn_control(7,LD) 

fctn_sq_on_7 

fctn_control(7,SQ_ON) 

fctn_sq_off_7 

fctn_control(7,SQ_OFF) 

fctn_rxnt_7 

fctn_control(7,RXMT) 

fctn_rem_7 

fctn_control(7,REM) 
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Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Call: 


fctn_z_fh_7 
fctn_control  (7  ,Z_FH) 

fctn_off_7 

fctn_control(7,FCTN_OFF) 

comsec_pt_7 

comsec_control(7,PT) 

comsec_ct_7 

comsec_control(7,CT) 

comsec_td_7 
comsec_control  (7  ,TD) 

comsec_rv_7 
conisec_control(7  ,RV) 

comsec_z_7 

comsec_control(7  ,COM_Z) 
rf_pwr_lo_7 

pwr_control  (7  ,PWR_LO) 

rf_pwr_m_7 

pwr_control(7,PWR_M) 

rf_pwr_hi_7 

pwr_control  (7  ,PWR_HI) 

rf_pwr_pa_7 

pwr_control(7,PWR_PA) 

comm_talk_a_7 

talk_control  (7  ,posi  tionCommander,  A) 
comm_talk_b_7 

talk_control  (7  ,posi  tionCommander,  B ) 
comm_talk_int_7 

talk_control(7,positionCommander,INT) 

loader_talk_a_7 

talk_control(7,positionLoader,A) 

loader_talk_b_7 

talk_control(7,positionLoader,B) 

loader_talk_int_7 

talk_control(7,positionLoader,lNT) 

driver_talk_a_7 

talk_control(7,positionDriver,A) 
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Function  Definition: 
Call: 


driver_talk_b_7 

talk_control(7,positionDriver,B) 


Function  Definition: 
Call: 


driver_talk_int_7 

talk_control(7,positionDriver,INT) 


Function  Definition: 
Call: 


gunner_talk_a_7 

talk_control(7,positionGunner,A) 


Function  Definition: 
Call: 


gunner_talk_b_7 

talk_control(7,positionGunner,B) 


Function  Definition: 
Call: 


gunner_talk_int_7 
talk_control(7  ,positionGunner,INT) 


Function  Definition:  nil_proc 


4.1.1.2  Contint  CSU  Design 

The  Contint  CSU  initializes  the  data  structures  and  mapping. 


4.1.2  Controls  CSU 

The  various  controls  functions  respond  to  individual  switch  positions.  For  example,  for 
the  mode  control  from  squelch  on  to  squelch  off,  the  appropriate  controls  function  would 
be  called  to  disable  squelching. 


4.1.2.1  Controls  CSU  Design  Specification/Constraints 


Function  Definition;  SetHopInfo 
Arguments:  (fp,  chan) 

Call:  SetTunerHopInfo(idcPortTable[fp  -  panelTable].i_radio, 

&hopinfo); 


Function  Definition:  control_control 
Arguments:  (fp) 

Calls:  clear_fp7(fp); 

SetTunerFrequency(idcPortTable[fp  -  panelTable].i_radio,0, 
FALSE); 

update_fp_power(fp,  SMALL_RCVD_POWER,  FALSE); 
copy_in_fp7(fp->fp_display, "  TST  NYI"); 
SetTunerFrequency(idcPortTable[fp  -  panelTable].i_radio,fp- 
>intemal.channel_freq[chan],chan  ==  CUE); 
copy_in_fp5(fp->fp_dispIay,  "  COLD  "); 
clear_fp5(fp); 

SetHopInfo(fp,  chan); 
copy_in_fp5(fp->fp_display, "  L7  L8  "); 
copy_in_fp5(fp->fp_display, "  L7  "); 
set_update_flag(fp,  TRUE); 
copy_in_fp5(fp->fp_display, "  L8  "); 
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Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 
00188: 

Call: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


set_update_flag(fp,  TRUE); 
clear_fp5(fp); 

copy_in_fp7(fp->fp_display,  ”  REMOTE  "); 
copy_in_fp7(fp->fp_display,  "  Z-FH  "); 
SetTunerFrequency(idcPortTable[fp  -  panelTable].i_radio,0, 
FALSE); 

update_fp_power(fp,  SMALL_RCVD_POWER,  FALSE); 

clear_lockouts(fp); 

clear_channels(fp); 

clear_tod(fp); 

clear_comsec(fp); 

cancel_delay(fp); 

SET_MODE(fp,  DEFAULT_MODE); 
set_update_flag(fp,  TRUE); 

channel_control 

(idc_index,sw) 

control_control(fp); 

mode_control 

(idc_index,sw) 

control_control(fp); 

fctn_control 

(idc_index,sw) 

update_fp_power(fp,  SMALL_RCVD_POWER,  TRUE); 
control_control(fp); 

comsec_control 

(idc_index,sw) 

pwr_control 

(idc_index,swi) 

print_at(&panelTable[idc_index],0,xchar(h_LVL2)); 

set_update_flag(&panelTable[idc_index],TRUE); 

print_at(&panelTable[idc_index],0,xchar(h_LVL3)); 

set_update_flag(&panelTable[idc_index],TRUE); 

print_af'&panelTable[idc_indcx],0,xchar(h_LVL5)); 

set_update_flag(&panelTable[idc_index],TRUE); 

print_at(&panelTable[idc_index],0,xchar(h_LVL7)); 

set_update_flag(&panelTable[idc_index],TRUE); 

talk_control 
(idc_index,who,sw) 
update_talk_control(idc_index,who); 
update_talk_control(pp  -  panelTable,  who); 

void  key_radio 
(rp,  new_key,  speaker) 

fprintf(astStream,  "Transmitter  keyed  while  receivingXn"); 
SendTransmitterPDU(rp,  FALSE); 
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Function  Definition:  update_talk_control 
Arguments:  (idc_index,who) 

Calls  panelTable[idc_index].push_to_talk); 

panelTable[idc_index].push_to_talk); 

fflush(stdout); 

key_radio(idcPortTable[idc_index].i_radio,R_KEYED_PREEMPT 
,  idcPortTable[idc_index].i_radio->r_speaker); 

desynchronize(idcPortTable[idc_index].i_radio); 


Function  Definition:  soft_reset 
Arguments:  (idc_index,sw) 

Call:  set_liglit_val(reset_table[idc_index],sw); 


Function  Definition:  set_beep 

Arguments:  (idc_index,sw) 

Call :  set_ligh  t_val  (beep_table  [idc_index] ,  sw) ; 


Function  Definition:  alert_operator 
Arguments:  (rp) 

Call:  beep_fp(rp->r_fps); 


4.1.2.2  Controls  CSU  Design 

The  controls  CSU  has  the  functions  mapped  by  contint.c  via  libcontrols  to  the  front  panel 
switches. 


4.1.3  Data  CSU 

The  data  CSU  contains  the  global  data  structures. 

4. 1.3.1  Data  CSU  Design  Specification/Constraints 
The  Data  file  has  no  design  specifications  or  constraints. 

4. 1.3.2  Data  CSU  Design 

Not  applicable. 

4.1.4  Erf  CSU 

The  erf  CSU  implements  the  electronic  remote  fill  simulation  for  frequency  hop  mode.  It 
permits  presets  on  the  radio  to  be  loaded  by  a  remote  simulated  radio. 
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4. 1.4.1  Erf  CSU  Design  Specification/Constraints 

Function  Definition:  erf_receive_data 

Arguments:  (fp,  src,  snr,  data,  size) 

Calls:  fprintf(astStream,  "erf_receive_data:  wrong  size  (%d)\n",  size); 

exit(l); 

Function  Definition:  aerf_tick() 

Calls:  copy_in_fp5(fp->fp_display,  "  L7  L8  "); 

copy_in_fp5(fp->fp_display,  "  L7  "); 
set_update_flag(fp,  TRUE); 
copy_in_fp5(fp->fp_display,  "  L8  "); 
set_update_flag(fp,  TRUE); 

HLD_n_mode(fp,  0); 

HLDln_mode(fp,  0); 

fprintf(astStream,  "erf_tick:  Unknown  ERF  kind  %d\n", 

fp->intemal.erf_msg.erf_kind); 

key_radio(rp,  0,  speakerUnknown); 

HLD_n_mode(fp,  0); 

HLDln_mode(fp,  0); 

key_radio(rp,  R_KEYED_ERF,  speakerERF); 
rt_transmit_erf(rp,&fp->internal.erf_msg,sizeof(fp- 
>intemal.erf_msg),sync  Preamble  1 ); 
rt_transmit_erf(rp,&fp->intemal.erf_msg,sizeof(fp- 

>intemal.erf_msg),fp->intemal.erf_msg.erf_ffagment 
==fp->intemal.eif_msg.erf_nffagments  ?syncEOM 
:syncNormal); 

Function  Definition:  erf_transmit_hopset 

Arguments:  (fp,  hopset,  tod_offset,  lockout7,  lockout8) 

Function  Definition:  erf_transmit_lockout 
Arguments:  (fp,  lockout) 


4.1,4,2  Erf  CSU  Design 

For  the  frequency  hop  mode,  the  erf  simulates  l)transmission  of  electronic  remote  fill 
information  from  the  front  panel,  and  2)  reception,  processing,  and  storage  of  electronic 
remote  fill  information  with  the  simulated  radii*. 


4.1.5  Fpt  CSU 

The  fpt  CSU  is  the  basis  of  the  front  panel  interface.  It  reads  keypresses  and  updates  the 
displays  above  the  front  panel’s  keypad. 


4. 1.5.1  Fpt  CSU  Design  Specification/Constraints 

Function  Definition:  u_char  xchar 
Arguments:  (c) 

Returns:  val 

-1 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 

Returns: 

Return: 

Return: 

Return: 

Return: 

Function  Definition: 
Arguments: 
Return: 

Return: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Call; 

Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 

Call: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 


set_mode 
(fp,  mode) 

sprintf(mode_bf,  "strange  mode  %d",  mode) 
mode_names[(int)  mode] 

fprintf(astStream,  "fpt  %d:  mode  =  %s.\n",  fp  -  panelTable,  s) 

open_fp 
(pfn,  fp) 

motif_panel(pfn,  fp  -  panelTable) 

0,-1 

1 

-1 

-1 

-1,0 

close_fp 
(pfd,  pt) 

-1 

-l,pfd 


getcu 
(kfd,  ch) 

shift_r_fp 
(dibuf,  ch) 

shift_l_fp 
(dibuf,  ch) 

nfill_fp 

(dibuf,  num,  ch) 

copy_in_fp 
(dibuf,  str) 

ncopy_in_fp(dibuf,  str,  0,  8) 

copy_in_fp5 
(dibuf,  str) 

ncopy_in_fp(dibuf,  str,  1,  5) 

copy_in_fp7 
(dibuf,  str) 

ncopy_in_fp(dibuf,  str,  1,  7) 

ncopy_in_fp 

(dibuf,  str,  start,  num) 

xchar(str[i]) 

copy_in 
(dibuf,  str) 

print_at 
(fp,  num,  ch) 
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Fu  iction  Definition:  print_char_at 
Arguments:  (^,  num,  ch) 

Call:  xchar(ch) 

Function  Definition:  del_chars 
Arguments:  (dibuf,  ch,  rch) 

Function  Definition:  print_fp 
Arguments:  (fp,  ch) 

Function  Definition:  print_char_fp 
Arguments:  (^,  ch) 

Call:  xchar(ch) 

Function  Definition:  reset_cursor 
Arguments:  (^) 

Function  Definition:  set_cursor 
Arguments:  (fp,  num) 

Function  Definition:  erase_fp 
Arguments:  (fp,  ch) 

Call:  print_at(fp,  fp->intemal.cursor,  ch) 

Function  Definition:  clear_fp7 
Arguments:  (^) 

Call:  ncopy_in_fp(fp->fp_display, "  ",  1, 7) 

Function  Definition:  clear_fp5 
Arguments:  (fp) 

Call:  ncopy_in_fp(fp->fp_display, "  ",  1,5) 

Function  Definition:  clear_tod 
Arguments:  (fp) 

Function  Definition:  clear_channels 
Arguments:  (fp) 

Function  Definition:  clear_lockouts 
Arguments:  (fp) 

Function  Definition:  clear_comsec 
Arguments:  (fp) 

Function  Definition:  clear_transec 
Arguments:  (fp) 

Function  Definition:  set_tod_day 

Arguments:  (^,  channel,  new_day) 

Call:  ftime(&now) 

Function  Definition:  set_tod_sec 

Arguments:  (fp,  channel,  new_second) 
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Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Call: 

Return: 

Return: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


standard_lockouts 

(fp) 

standard_tod 

(fp) 

time(&now) 
set_tod_day(fp,  i,  1) 
set_tod_sec(fp,  i,  now  %  86400) 

standard_channels 

(fp) 

standard_transec 

(fp) 

standard_comsec 

(^) 

init_fp 
(fp,  ch) 
ftime(&now) 

nfill_fp(fp->fp_display,  8,  ch) 

set_beep(fp-panelTable,  FALSE) 

reset_fps(fp) 

standard_lockouts(fp) 

standard_tod(fp) 

standard_channels(fp) 

standard_comsec(fp) 

standard_transec(fp) 

update_fp_power(fp,  SMALL_RCVD_POWER,  TRUE) 

int  update„fp 
(kfd_fp,  fpbuO 

display_codes(krd_^.u.motif_info,  fpbuO 
(write(kfd_^.u.fd,  fpbuf,  8)) 

8 

set_update_flag 
(fp,  val) 

execute_fp 
(fp,  ch) 

fprintf(astStream,  "fpt  %d:  execute  %02x\n",  fp  -  panelTable,  ch) 
freq_enter_mode(fp,  ch); 
erf_ofst_mode(fp,  ch) 

HLD _ mode(fp,  ch) 

HFnnn_mode(fp,  ch) 

HLDl _ mode(fp,  ch) 

HLnnn_mode(fp,  ch) 

STO _ mode(fp,  ch); 

STOl _ mode(fp,  ch); 

TOD_mode(fp,  ch) 
enter_TOD_mode(fp,  ch) 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


hopset_display_mode(fp,  ch) 
hopset_enter_mode(fp,  ch) 

clr _ mode(fp,  ch) 

clrl _ mode(fp,  ch) 

fprintf(astStream,  "execute_fp:  Missing  case  for  mode  %d.',n",fp- 
>intemal.mode) 

SET_MODE(fp,  DEFAULT_MODE) 
default_mode(fp,  ch) 

default_mode 
(fp,  ch) 
beep_fp(fp) 

start_hopset_display_mode(fp) 
start_freq_enter_mode  (fp) 
frequency_display_mode(fp) 
start_erf_ofst_mode(fp) 

HFnnn_mode(fp,  ch) 

HLnnn_mode(fp,  ch) 
start_TOD_mode(fp) 
start_load(fp) 

start_hopset_clear_mode(fp) 

update_fp_power 
pwr,  state) 

print_char_at(fp,  0,  ch) 
set_update_flag(fp,  TRUE) 

update_transmit_power 
(fp,  on) 

print_char_at(fp,  0,  ch) 
set_\ipdate_flag(fp,  TRUE) 

stait_hopset_clear_mode 

(fp' 

copy_in_fp5(fp->fp_display,  "  CLR  _  ") 
sei_update_flag(fp,  TRUE) 

SET_MODE(fp,  CLR _ MODE) 

clr_n_mode 
(fp,  digit) 

copy_in_fp5(fp->fp_display, "  CLR  ") 
print_at(fp,  5,  digit) 
set_update_flag(fp,  TRUE) 
beep_fp(fp) 

SET_MODE(fp,  DEFAULT_MODE) 

clr _ mode 

(fp,  ch) 

cli_to_digit(ch) 

clear_fp7(fp) 

set_update_flag(fp,  TRUE) 

set_delay(fp,  TIME_BLINK,  clr_n_mode,  digit) 

SET_MODE(fp,  CLR_n_MODE) 
print_char_at(fp,  4,  (char)  h_LOUT) 
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Function  Definition 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition; 
Arguments; 
Calls: 


Function  Definition: 
Arguments; 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


set_update_flag(fp,  TRUE) 

SET_MODE(fp,  CLRl_MODE) 

clrln_mode 
(fp,  digit) 

copy_in_fp5(fp->fp_display,  "  CLR  ") 
print_char_at(fp,  4,  (char)  h_LOUT) 
print_char_at(fp,  5,  'O'  +  digit) 
set_update_flag(fp,  TRUE) 
beep_fp(fp) 

SetHopInfb(fp,  fp->channel_num) 
SET.MODECfj),  DEFAULT_MODE) 

clrl _ mode 

(fp,  ch) 

ch_to_digit(ch) 

clear_fp7(fp) 

set_update_flag(fp,  TRUE)  . 

set_delay(fp,  TIME_BLINK,  clrln_mode,  digit) 

SET_MODE(fp,  CLRln_MODE) 

start_hopset_display_mode 

(fp) 

SET_MODE(fp,  HOPSET_DISPLAY_MODE) 
hopset_display_mode(fp,  FREQ) 

hopset_display_mode 
(fp,  ch) 

start_hopset_enter_mode(fp) 

clear_fp7(fp) 

SET_MUDE(fp,  DEFAULT_MODE) 
default_mode(fp,  ch) 
copy_in_fp5(fp->fp_display,  s) 
int_to_display3(fp->fp_display,  n) 
set_update_fiag(fp,  TRUE) 

start_hopset_enter_mode 

(fp) 

SET_MODE(fp,  HOPSET_ENTER_MODE) 
print_char_at(fp,  4, '_') 
print_char_at(fp,  5, '_') 
set_update_flag(fp,  TRUE) 
set_cursor(fp,  4) 

hopset_enter_mode 
(fp,  ch) 

ch_to_digit(ch) 
print_fp(fp,  digit) 
set_update_flag(fp,  TRUE) 
erase_fp(fp,  xchar('_')) 
set_update_.flag(fp,  T^UE) 
display  _to_int3(fp->fp_display) 
copy_in_fp5(fp->fp_di''play, "  STO_  ") 
set_update_flag(fp,  TRUE) 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


SET_MODE(fp,  STO _ MODE) 

SET_MODE(fp,  DEFAULT_MODE) 
default_mode(fp,  ch) 

frequency_display_mode 

(fp) 

copy_in_fp5(fp->fp_display, "  0  ") 

int_to_display(fp->fp_display,fp->internal.channel_freq[fp- 
>channel_num]) 
set_update_flag(fp,  TRUE) 

start_freq_enter_mode 

(fp) 

SET_MODE(fp,  FREQ_ENTER_MODE) 
ser_cursor(fp,  1) 

copy_in_fp5(fp->fp_display, "  FILLO  ") 
print_char_at(f^p,  5,  '0') 
print_char_at(fp,  5,  ’C) 

else  print_char_at(f^p,  5,  '0'  +  (OxOf  &  ^->channel_num)) 
else  int_to_display(fp->fp_display, 
fp->intemal.channel_freq[fp->channel_num]) 
set_update_flag(fp,  TRUE) 

canceLmode 
(fp,  mode_mask) 

SET_MODE(fp,  DEFAULT.MODE) 
channel_control(fp  -  panelTable,  fp->channel_num) 

freq_enter_mode 
(fp,  ch) 

ch_to_digit(ch) 
print_fp(fp,  digit) 

copy_in_fp5(fp->fp_display, " _  ") 

set_cursor(fp,  1) 

else  erase_fp(fp,  xchar('_')) 

set_update_flag(fp,  TRUE) 

SET_MODE(fp,  DEFAULT_MODE) 

cancel_delay(fp) 

copy_in(temp,  fp->fp_display) 

del_chars(temp,  xchar('_’),  xchar(' ')) 

display_to_int(temp) 

blink_display(fp) 

clear_fp5(fp) 

set_update_flag(fp,  TRUE) 

set_delay(fp,  7000,  canceLmode,  1  «  FREQ_ENTER_MODE) 
set_update_flag(fp,  TRUE) 

start_erLofst_mode 

(fp) 

SET_MODE(fp,  ERF_OFST_MODE) 
set_cursor(fp, !) 

copy_in_fp5(fp->fp_display,  ofst[fp- 
>internai.ofst_index[channel]]) 
set_update_flag(fp,  TRUE) 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Call: 


Function  Definition: 
Arguments: 
Calls: 


erf_ofst_mode 
(fp,  ch) 
clear_fp7(fp) 

SET_MODE(fp,  DEFAULT_MODE) 
copy_in_fp5(fp->fp_display,ofst[fp->intemal.ofst_index[fp- 
>channel_num]]) 
set_update_flag(fp,  TOUE) 
set_update_flag(fp,  TRUE) 

stanjoad 

(fp) 

copy_in_fp5(fp->fp_display,  "  HLD  _  ") 

SET_MODE(fp,  HLD _ MODE) 

set_update_flag(fp,  TRUE) 

HLDln_mode 
(fp,  first_time) 

copy_in_fp5(fp->fp_display,  "  HL _  ") 

int_to_display3(fp->fp_display,  fp->intemal.holding_\'alue) 

set_update_flag(fp,  TRUE) 

beep_fp(fp) 

blink_display(fp) 

set_delay(fp,  7000,  HLDln_mode,  0) 

SET_MODE(fp,  HLnnn_MODE) 

HLDl _ model 

(fp,  lockout_num) 
xchar('0'  +  lockout_num) 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  HLDln.MODE) 
fp->intemal.lockout[LKOUT(lockout_num)] 
set_delay(fp,  500,  HLDln_mode,  0) 

HLDl  mode 
(fp,  ct 

ffl^Dl _ iiiOdel(fp,  1) 

HLDl _ model(fp,  2) 

HLDl _ model(fp,  3) 

HLDl _ model(fp,  4) 

HLDl_model(fp,  5) 

HLDl _ model(fp,  6) 

HLDl_model(fp,  7) 

HLDl _ model(fp,  8) 

HLnnn_mode 
(fp,  ch) 

cancel_delay(fp) 

erf_transmit_lockout(fp,  fp->internal.holding_value) 
copy_in_fp5(fp->fp_display,  "  SEND  ") 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  ERF_SEND_MODE) 
cancel_delay(fp) 

copy_in_fp5(fp->fp_display,  "  STO  _  ") 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


print_char_at(fp,  4,  h_LOUT) 

STOl _ model(fp,  lockout_num) 

cancel_delay(fp) 

SET_MODE(fp,  DEFAULT_MODE) 
default_mode(fp,  ch) 

STO _ model 

(fp,  channel) 

print_char_at(fp,  5,  'O'  +  channel) 
set_update_flag(fp,  TRUE) 
blink_display(fp) 
beep„fp(fp) 
cancel_delay(fp) 

SET_MODE(fp,  DEFAULT.MODE) 

STO _ mode 

(ip,  ch) 

STO _ modeKfp,  1) 

STO _ model(fp,  2) 

STO _ modeKfp,  3) 

STO _ modeKfp,  4) 

STO _ modeKfp,  5) 

STO _ modeKfp,  6) 

ST01_model 
(fp,  lockout_num) 

print_char_at(fp,  5,  'O'  +  lockout_num) 

set_update_flag(fp,  TRUE) 

blink_display(fp) 

beep_fp(^) 

cancel_delay(fp) 

SET_MODE(fp,  DEFAULT.MODE) 

STOl _ mode 

(fp,  ch) 

S'TOl _ modeKfp,  1)‘,  break 

STOl _ modeKfp,  2);  break 

STOl _ modeKfp,  3);  break 

STOl _ modeKfp,  4);  break 

STOl _ modeKfp,  5);  break 

STOl _ modeKfp,  6);  break 

STOl _ modeKfp,  7);  break 

case  EIGHT:  STOl _ modeKfp,  8);  break 

HLD_n_mode 
(fp,  first_time) 

copy_in_fp5(fp->fp_display, "  HF  ") 

int_to_display3(fp->fp_display,  fp->intemal.holding_value) 

set_update_flag(fp,  TRUE) 

beep_fp(fp) 

blink_display(fp) 

set_delay(fp,  7000,  HLD_n_mode,  0) 

SET_MODE(fp,  HFnnn_MODE) 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 
Calls: 


HLD _ model 

(fp,  channel) 

print_char_at(fp,  5,  'O'  +  channel) 
set_update_flag(fp,  TRUE) 

SET_MODE(f5,  HLD_n_MODE) 
set_delay(fp,  500,  HLD_n_mode,  1) 

HLD _ mode 

(fp,  ch) 

HLD _ model(fp,  1);  break 

HLD _ model(fp,  2);  break 

HLD _ model(fp,  3);  break 

HLD _ model(fp,  4);  break 

HLD _ model(fp,  5);  break 

HLD _ model(fp,  6);  break 

copy_in_fp5(fp->fp_display, "  HLD  _  ") 
print_char_at(fp,  4,  h_LOUT) 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  HLDl_MODE) 

HFnnn_mode 
(fp,  ch) 

cancel_delay(fp) 

copy_in_fp5(fp->fp_display, "  TOD  ") 

SET_MODE(fp,  DEFAULT.MODE) 
set_update_flag(fp,  TRUE) 
erf_transmit_hopset(fp,fp->intemal.holding_value,fp- 

>intemal.holding_tod_offset,fp->intemal.holding_lockout7,fp- 
>intemal.holding_lockout8) 
copy_in_fp5(fp->fp_display, "  SEND  ") 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  ERF_SEND_MODE) 
copy_in_fp5(fp->fp_display, "  STO  _  ") 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  STO _ MODE) 

SET_MODE(fp,  DEFAULT_MODE) 
default_mode(fp,  ch) 

channel_time 

(fp,  channel,  dayp,  hourp,  minutep,  secondp,  msecp) 
ftime(&now) 

update_T  OD_mode 

(ft) 

channel_time(fp,  channel,  &day,  ^rliour,  &minute,  &second, 
&msec) 
clear_fp7(fp) 

print_char_at(fp,  1 ,  'O'  +  day  /  10) 
print_char_at(fp,  2,  'O'  +  day  %  10) 
print_char_at(fp,  1,  'O'  +  hour  /  10) 
print_char_atftp,  2,  'O'  +  hour  %  10) 
print_char_at(fp,  4,  'O'  +  minute  / 10) 
print_char_at(fp,  5,  'O'  +  minute  %  10) 
print_char_atftp,  1,  'O'  +  minute  / 10) 
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Function  Definition; 
Arguments: 
Calls: 


Function  Definition; 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Returns 

Function  Definition; 
Arguments: 
■Calls: 


print_char_at(fp,  2,  'O'  +  minute  %  10) 
print_char_at(fp,  4,  'O'  +  second  /  10) 
print_char_at(fp,  5,  'O'  +  second  %  10) 
set_update_flag(fp,  TRUE) 

.set_delay(fp,  1000  -  msec,  update_TOD_mode) 

start_TOD_mode 

(fp) 

SET_MODE(fp,  TOD_DAYS_MODE) 
update_TOD_mode(fp) 

TOD_mode 
(fp,  ch) 

ch_to_digit(ch) 

update_TOD_mode(fp) 

SET_MODE(fp,  TOD_ENTER_DAYS_MODE) 

copy_in_fp5(fp->fp_display, " ") 

SET_MODE(fp,  TOD_ENTER_HHMM_MODE) 

copy_in_fp5(fp->fp_display,  " _ ") 

cancel_delay(fp) 
set_cursor(fp,  1) 
set_update_flag(fp,  TRUE) 

SET_MODE(fp,  TOD_HHMM_MODE) 

SET_MODE(fp,  TOD_MMSS_MODE) 

SET_MODE(fp,  TOD_DAYS_MODE) 

update_TOD_mode(fp) 

cancel_delay(fp) 

clear_fp7(fp) 

SET_MODE(fp,  DEFAULT.MODE) 
default_mode(fp,  ch) 

ch_to_digit 

(ch) 

1,2,3,4,5,6,7,8,9,0,-1 

enter_TOD_mode 
(fp,  ch) 

ch_to_digit(ch) 
print_char_fp(fp,  'O'  +  digit) 
print_char_fp(fp,  '0'  +  digit) 
erase_fp(fp,  xchar(’_')) 

SET_MODE(fp,  TOD_DAYS_MODE) 

set_tod_day(fp,  fp->internal.tod_channel_num,fp->fp_display[  1  ]  * 
10  +fp->f^p_display[2]) 

SET^MODE(fp,  TOD_HHMM_MODE) 

set_tod_sec(fp,  fp->intemal.tod_channel_num,fp->fp_display[l]  * 
36000  +fp->fp_display[2]  *  3600  +fp->fp_display[4]  *  600 
+fp->fp_display[5]  *  60) 
update_T  OD_mode  (fp ) 
blink_display(fp) 
cancel_delay(fp) 
clear_fp7(fp) 

SET_IVIODE(fp,  DEFAULT_MODE) 
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default_mode(fp,  ch) 
set_update_flag(fp,  TRUE) 

Function  Definition:  int  is_zero 
Arguments:  (buf) 

Returns  (TRUE), (FALSE) 

Function  Definition:  int  display_to_int 
Arguments:  (buf) 

Returns  (0),(sum) 

Function  Definition:  int  display_to_int3 
Arguments:  (buf) 

Returns  (0),(sum) 

Function  Definition:  int_to_display 
Arguments:  (buf,  num) 

Function  Definition:  int_to_display3 
Arguments:  (buf,  num) 

Function  Definition:  beep_fp 
Arguments:  (fp) 

Calls:  ftime(&etm) 

set_beep(fp-panelTable,  TRUE) 

Function  Definition:  check_beep 
Arguments:  (fp) 

Call:  ftime(&etm) 

Function  Definition:  set_delay 

Arguments:  (fp,  delay,  fn,  arg) 

Call:  ftime(&etm) 

Function  Definition:  cancel_delay 
Arguments:  (fp) 

Function  Definition:  check_delay 
Arguments:  (fp) 

Calls;  ftime(&etm) 

cancel_delay(fp) 

(*fn)(fp,  fp->intemal.delay_arg) 

Function  Definition:  fpt_receive_cue 
Arguments:  (fp) 

Calls:  copy_in_fp7(fp->fp_display, "  CUE  ") 

set_update_flag(fp,  TRUE) 
beep_fp(^) 

Function  Definition:  reset,  fps 
Arguments:  (fp) 

Calls:  ftime(&etm) 

soft_reset(fp-panelTable,  TRUE) 
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Function  Definition:  check_reset 
Arguments:  (fp) 

Calls:  ftime(&etm) 

soft_reset(fp-panelTable,  FALSE) 


Function  Definition:  blink_di splay 
Arguments:  (fp) 

Calls:  ftime(&etm) 

ncopy_in_fp(buf, "  ",  0,  8) 

update_fp(^->intemal.key_io,  buf) 
set_update_flag(fp,  FALSE) 


Function  Definition:  check_blink 
Arguments:  (fp) 

Calls:  ftime(&etm) 

set_update_flag(fp,  TRUE) 


Function  Definition.  fp_show 
Arguments:  (argc,  argv) 

Calls:  RprintfC'bad  front  panel  index;  must  be  0  <=  idx  <=  %d\n", 

MAXJDC.CHANNELS- 1 ) 

Rprintf( "Function:  %s\n",  fctn_names[(int)  fp->fctn]) 

Rprintf("  Mode:  %s'^",  mode_names[(int)  ^->mode]) 
Rprintf("  Power:  %s\n",  power_names[(int)  fp- 

>rf_power]);02055:  Rprintf("  Comsec:  %s\n", 

comsec_names[(int)  fp->comsec]) 

RprintfC'Lockouts:") 

Rprintf("  HIw%3d",  fp->intemal.lockout[LKOUT(i)]) 

Rprintf("\n' ) 

Rprintf("  Transec:  TK%03d\n",  fp->intemal.transec) 

RprintfC  Channel:  %d\n",  fp->channel_num) 

Rprintf("  Frequency  Hopset  L7  L8  COMSEC 

Day  HHMM:SS\n") 

channel_time(fp,  channel,  &day,  &hour,  &minute,  &second, 
&msec) 

sprintf(channel_name_buf,  "chan  %d",  channel) 
sprintf(hopset_buf,  "HF%03d",  fp->internal.hopset[channel]) 
Rprintf(  "%8s:  %5d%3sKHz  %s  %s  %s  RK%03d  %3d 
%02d  %02d :  %02dNn "  ,c  h  annel_name,fp- 
>intemal.channel_freq[channel],ofst_names[fp- 
>internal  .ofst_index  [channel]  ]  ,hopset_string,fp- 
>intemal.lockout7 [channel]  ?  "L7" : "  ",fp- 
>internal.lockout8 [channel]  ?  "L8" : "  ",fp- 
>intemal.comsec[channel],day,  hour,  minute,  second) 


Function  Definition:  fp_set 
Arguments:  (argc,  argv) 

Call:  RprintfC'bad  front  panel  index;  must  be  0  <=  idx  <=  %d\n”, 
MAX_IDC_CHANNELS- 1 ) 
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4.1.5.2  Fpt  CSU  Design 

The  fpt  CSU  calls  an  open  function,  a  close  function,  a  keypad  read  function,  and  a  set  of 
display  update  functions,  most  of  which  are  in  controls.c. 

4.1.6  Lrp  CSU 

The  lrp  (Longeley-Rice  propagation  model)  CSU  maintains  the  transmission  loss  table. 

4.1.6.1  Lrp  CSU  Design  Specification/Constraints 


Function  Definition:  aknife 
Arguments:  (v2) 

Returns:  (6.02) 

(6.02  +  9.11  *  SQRT  (v2)  -  1.27  *  v2) 
(12.953 +  4.343  *  LOG  (v2)) 

Function  Definition:  fht 
Arguments:  (x,  pk) 

Return:  retval 

Function  Definition:  adiff 
Arguments:  (d,  ink) 

Returns:  0.0 

retval 

Function  Definition:  alos 
Arguments:  (d,  ink) 

Returns:  0.0 

retval 

Function  Definition:  hOf 
Arguments:  (r,  et) 

Return:  retval 


Function  Definition:  ahd 
Arguments:  (td) 

Return:  (a[i]  +  b[i]  *  td  +  c[i]  *  LOG  (td)) 


Function  Definition:  ascat 
Arguments:  (d,  ink) 

Returns:  0.0 

1001.0 

ss  =  (d  -  ad)  /  (d  +  ad) 

(ahd  (th  *  d)  +  4.343  *  LOG  (47.7  *  th  *  th  *  th  *  th  *  Ird.wn)  -  0.1 
*  (Ird.ens  -  301.0)  *  EXP  (-th  *  d  /40.0e+3)  +  hO) 


Function  Definition:  Irprop 
Arguments:  (d) 
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Function  Definition: 

qtile 

Arguments: 

(nn,  aa,  ir) 

Return: 

q 

Function  Definition: 

zlsql 

Arguments: 

(pth,  xl,  x2,  zO,  zn) 

Function  Definition: 

dlthx 

Arguments: 

(pth,  xl,  x2) 

Returns: 

0.0 

retval 

Function  Definition: 

hzns 

Function  Definition: 

qlrpfl 

Arguments: 

(pth,  klimx,  mdvarx) 

Function  Definition: 

qlrps 

Arguments: 

(fmhz,  zsys,  enO,  ipol,  eps,  sgm) 

Function  Definition: 

avar 

Arguments: 

(zzt,  zzl,  zzc) 

Return: 

retval 

Function  Definition: 

qlra 

Arguments: 

(kst,  klimx,  mdvarx) 

Function  Definition: 

qerf 

Arguments: 

(z) 

Return: 

retval 

Function  Definition: 

qerfi 

Arguments: 

(q) 

Returns: 

retval 

(-eno) 

0 

Function  Definition: 

bld_tra 

Arguments: 

(tm) 

Returns: 

-eno 

-eno 

0 

Function  Definition: 

load_trn 

Arguments: 

(tm,  tfn) 

Returns: 

-eno 

-1 

0 

Function  Definition: 

get_pfl 

Arguments: 

(tm,  pth) 

Returns: 

-1 

Function  Definition: 

LoadTerrain 
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Function  Definition:  UpdateLoss 

Arguments:  (vpa,  vpb,  tp,  pair) 


4. 1.6.2  Lrp  CSU  Design 

The  lrp  CSU  is  a  tree  of  functions  invoked  by  a  loop  in  main.c.  It  is  a  translation  of  the 
FORTRAN  code  described  in  NTIA  Report  82-100,  A  Guide  to  the  Use  of  the  ITS 
Irregular  Terrain  Model  in  the  Area  Prediction  Mode. 


4.1.7  Main  CSU 

The  main  CSU  is  the  main  loop  and  the  entry  point  for  the  simulation. 


4.1.7.1  Main  CSU  Design  Specification/Constraints 


Function  Definition:  main 

Arguments:  (argc,  argv) 

Calls:  perror("plock(PROCLOCK)  failed"); 

fprintf(stderr,  "Continuing  anyway.'oi"); 
fopen(errport,  "a"); 

fprintf(stderr,  "Using  stderr,  in  place  of  %s,  for 
astS  tream.Nn "  ,errport) ; 
print_banner(); 

signal(SIGINT,  exit_gracefully); 
signal(SIGTERM,  exit_gracefully); 
tty_setup_modes(); 
atoi(optarg); 

InitlDCsQ; 

riu_init(&  riuTable[idx]); 
timingJnitO; 

printf ("Initializing  fake  simvad  timer\n"); 

printf("tty_parser_init...\n"); 

tty_parser_init(command_table,  "RAD10> "); 

tty_tick(); 

simvads_restart(); 

Function  Definition:  static  void  ComputeLosses 

Call:  VehicleIDtoIndex(rp->r_radio_id. vehicle); 

Function  Definition:  static  int  TickHandler 

Function  Definition:  static  void  InitFakeSimvad 

Function  Definition:  static  int  Handle  AST 
Calls:  timing_start(0); 

timing_inter_ast(net_current_time(network_get_descriptor())); 

timing_start(l); 

timing_end(l); 

timing_start(2); 
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Function  Definition: 
Calls: 


Function  Definition: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Return: 


riu_tick(); 

timing_end(2); 

timing_start(3); 

erf_tick(); 

timing_end(3); 

timing_start(4); 

simvads_service(); 

timing_end(4); 

timing_start(5); 

CheckFrontPanelsO; 

timing_end(5); 

timing_start(6); 

(void)  AssocTickAssocLayerO; 

(void)  AssocTickAssocLayer(assocHandle); 

timing_end(6); 

fflush(astStream); 

timing_end(0); 

exit_gracefully 

exit(O); 

(void)  setpri(sv_get_astpri()); 

moti^_exit(X 

simvads_uninit(); 

timing_uninit(); 

tty_re  store_modes() ; 

printf("\n"); 

print_banner 

printfCV); 

printf("\n"); 

printfC'HAVEQUICK  Radio  Simulation\n"); 
printfC'SINCGARS  Radio  Simulation\n"); 
printf("%s\n",  radio_version); 

printf("BBN  Systems  and  Technologies  Corporation\n"); 

printf( "Cambridge,  MA,  02138\n"); 

printf("\n"); 

printf("\n"); 

printf("\n"); 

sleep(l); 

Rprintf 

(va_alist) 

va_start(args); 

va_arg(args,  char  *); 

setpri(sv_get_astpri()); 

vprintf(fmt,  args); 

setpri(pri); 

val; 
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Function  Definition:  xflush 
Arguments:  (f) 

Calls:  setpri(sv_get_astpri()); 

fflush(f); 
setpri(pri); 

Return:  val; 

Function  Definition:  main_need_simvads_restart 


4.1.7.2  Main  CSU  Design 


The  main  CSU  is  the  main  function.  It  calls  various  other  functions  in  the  simulation. 


4.1.8  Motifp  CSU 

The  motifp  CSU  is  an  X-windows  simulation  of  the  front  panel,  used  for  debugging. 


4.1.8.1  Motifp  CSU  Design  Specification/Constraints 


Function  Definition:  motifp_display_codes 

Arguments:  (info,  p) 

Calls:  SetArg(XmNlabelInsensitivePixmap,  info->display_pm9ps[c]); 

XtSetV.alues(info->display_widgets[i],  wargs,  nargs), 

Function  Definition:  static  "oid  keypad_button 

Arguments:  (w,  data,  cback) 

Call:  execute_fp(data->info->fp,  data->data); 

Function  Definition:  static  void  select_select 

Arguments:  (fn,  w,  data,  cback) 

Call:  XqButtonListDeselectPos(w,  cback->item_position); 

Function  Definition:  static  void  power_select 

Arguments:  (w,  data,  cback) 

Call:  select_select(pwr_confrol,  w,  data,  cback); 

Function  Definition:  static  void  channel_select 

Arguments:  (w,  data,  cback) 

Call:  select_select(channel_control,  w,  data,  cback); 

Function  Definition:  static  void  mode_select 

Arguments:  (w,  data,  cback) 

Call:  select_select(mode_control,  w,  data,  cback); 

Function  Definition:  static  void  function_select 

Arguments:  (w,  data,  cback) 

Call:  select_select(fctn_control,  w,  data,  cback); 
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Function  Definition; 
Arguments: 
Call: 

Function  Definition: 
Arguments: 
Calls; 


Function  Definition: 
Arguments: 
Call: 


Function  Definition: 
Arguments: 
Calls: 


Return: 

Function  Definition: 
Arguments: 
Calls: 


Return: 

Function  Definition: 
Arguments: 
Calls: 


s.atic  void  com'  \  tl  cr 
(w,  data,  cback) 

select_select(conisec.  control,  \v,  data,  cback); 

static  void  ptt_jelect 
(w,  data,  cback) 

talk_control(info->^  -  panelTable,  crew_position,data- 
>iTanslations[prev_position  -  1]); 
talk_coniTol(info  >fp  -  panelTable,  crew_position,data- 
>translations[this_position  -  1]); 

static  void  quit_seleci 
(w,  data,  cback) 
exit_gracefully(); 

static  Pixel  mid_color 
(w,  pixel  1,  pixel2) 

XtDisplay(w); 

XtScreen(w); 

DefaultColormapOfScreen(scr); 

XQueryColor(dpy,  cmap,  &colorl); 

XQueryColor(dpy,  cmap,  &color2); 

XAllocColor(dpy,  cmap,  &color3); 
color3  .pixel; 

static  Pixel  led_color 
(w) 

XtDisplay(w); 

XtScreen(w); 

DefaultColormapOfScreen(scr); 

XAllocColor(dpy,  cmap,  &color); 
color.pixel; 

static  Widget  create_selector 

(va_alist) 

va_start(pvar); 

va_arg(pvar,  MOTIFP_INFOP); 
va_arg(pvar.  Widget); 
va_arg(pvar,  char  *)• 
va_arg(pvar,  XtCailbm  kProc); 
va_arg(pvar,  int); 
va_arg(pvar,  int); 
va_arg(pvar,  int); 
va_end(pvar); 
va_start(pvar); 

(void)  va_arg(pvar,  MOTIFP_INFOP); 

(void)  va_arg(pvar.  Widget); 

(void)  va_arg(pvar,  char  *); 

(void)  va_arg(pvar,  XtCallbackProc); 

(void)  va_arg(pvar,  int); 

(void)  va_arg^var,  int); 

SetArg(XmNorientation,  XmVERTlCAL); 

SetArg(XmNisAligned,  False), 

XtCreateWidget(name,  xmRowColumnWidgetClass,  parent,wargs. 
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selector, wargs. 


Return; 

Function  Definition: 
Arguments: 
Returns: 


Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


nargs); 

sprintf(label_name,  "%s_laber’,  name); 
sprintf(choices_name,  ''%s_choices",  name); 
sprintf(frame_name,  "%s_frame",  name); 
XtCreateWidget(label_name,  xmLabelGadgetClass, 
nargs); 

XtCreateWidget(frame_name,  xmFrameWidgetClass, selector, 
wargs,  nargs); 
va_arg(pvar,  int); 

XmStringCreate(label,  info->’  ’  lharSet); 
va_end(pvar); 

SetArg(XmNitemCount,  num_Duuons); 

SetArg(XmNitems,  items); 

SetArg(XmNselectionPolicy,  XmSINGLE_SELECT); 
SetArg(XmNsingleSelectionCallback,  callbacks); 
SetArg(XmNhilitePolicy,  XmfflLITE_WHEN_SELECTED); 
XqCreateButtonList(choices_frame,  choices_name,  wargs,  nargs); 
XtFree(items); 

XtManageChild(choices); 

XtManageChildren(twidgets,  ntwidgets); 
selector, 

static  XmFontList  FontListAppend 
(oldfl,  font,  charset) 

XmFontListCreate(font,  charset); 

XmFontListAdd(oldfl,  font,  charset); 

static  void  InitFonts 
(info,  dpy) 

static  Widget  create_display 
(info,  parent,  name) 

XtDisplay(parent); 

XtScreen(parent); 

RootWindowOfScreen(scr); 

SetArg(XmNbackground  «feback ground); 
SetArg(XmNforeground,  &foreground); 

XtGetValues(parent,  wargs,  nargs); 
led_color(parent); 

mid_color(parent,  background,  BlackPixelOfScreen(scr)); 
SetArg(XmNbackground,  background); 

SetArg(XmNforeground,  foreground); 

XmCreateFrame(parent,  "display_frame",  wargs,  nargs); 
SetArg(XmNorientation,  XmHORIZONTAL); 
SetArg(XmNisAligned,  False); 

SetArg(XmNbackground,  background); 

XtCreateWidget(name,  xmRowColumnWidgetClass,frame,  wargs, 
nargs); 

bzero(bmap,  sizeof(bmap)); 

XCreatePixmapFromBitmapData(dpy,  win,  bmap,  10,  16,red, 
background,  8); 

XCreatePixmapFromBitmapData(dpy,  win,  bmap,  15,  24,red, 
background,  8); 

SetArg(XmNlabelType,  XmPIXMAP); 
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Return: 

Function  Definition: 
Arguments: 
Calls: 


wargs, 


Return: 

Function  Definition: 
Arguments: 
Calls: 

Function  Definition: 
Arguments: 
Calls: 


SetArg(XmNsensitive,  False); 

SetArg(XmNlabelInsensitivePixmap,  info->display_pmaps[0]); 
SetArg(XmNlabelPixmap,  info->display_pmaps[l]); 
SetArg(XmNbackground,  background); 

XtCreateWidgetC",  xmLabelGadgetClass,  display, wargs,  nargs); 
XtManageChildren(info->display_widgets,  8); 
XtManageChild(display); 
frame; 

static  Widget  create_keypad 
(info,  parent,  name) 

SetArg(XmNisAligned,  False); 

XtCreateWidget(name,  xmRowColumnWidgetClass,  parent, 
nargs); 

create_display(info,  keypad_area,"display"); 
XtCreateWidget("keypad_frame",  xmFrameWidgetClass, 
keypad_area,  wargs,  nargs); 

SetArg(XmNorientation,  XmHORIZONTAL); 
SetArg(XmNpacking,  XmPACK_COLUMN); 
SetArg(XmNnumColumns,  4); 

SetArg(XmNadjustLast,  False); 

SetArg(XmNis  Aligned,  False); 

XtCreateWidgetC'keypad", 

xniRowColumnWidgetClass,keypad_ffame,  wargs,  nargs); 
XmStringLtoRCreate(button_labels[i].ll,  info->labelCharSet); 
XmStringConcat(cs,  XmStringSeparatorCreate(l)); 
XmStringConcat(cs,XmStringLtoRCreate(button_labels[i].12,info- 
>labelCharSet)); 

XmStringConcat(cs,  XmStringS  eparatorC!reate(  1 )); 
XmStringConcat(cs, 

XmStringLtoRCreate(button_labels[i].13,nfo->digitCharSet)); 
SetArgCXmNlabelType,  XmSTRING); 

SetArg(XmNlabelString,  cs); 

SetArg(XmNdisarmCallback,  callbacks); 

XtCreateWidget(button_labels[i].name,xmPushButtonGadgetClass 
keypad,wargs,  nargs); 

XtManageChildren(kwidgets,  nkwidgets); 
XtManageChild(keypad); 

XtManageChildren(twidgets,  ntwidgets); 
keypad_area; 

static  void  CvtStringToWidget 
(args,  nargs,  fromVal,  toVal) 

XtParent((Widget)  args[0].addr); 

static  MOTIFP_INFOP  InitXt 

(argep,  argv,  label,  radio,  fp,  position,  ptt) 

XtCreateApplicationContextO; 

XtAppAddConverter(info->app,  XtRString,  XtRWindow, 
(I!vtStringToWidget,cvt_args,  XtNumber(cvt_args)); 
sprintf(panel_name,  "radio_panel_%s",  radio); 
XtOpenDisplay(info->app,  NULL,  panel_name,  "Radio",NULL,  0, 
argep,  argv); 

XtAppCreateShell(panel_name, 
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Return: 


Function  Definition: 
Arguments: 
Calls: 


"Radio",applicationShellWidgetClass,info->dpy,  NULL,  0); 
XtGetApplicationResources(info->frame,  &info- 

>application_data,app!ication_resources,XtNumber 
(application_resources),NULL,  0); 

InitFonts(info,  XtDisplay(info->frame)); 
XmCreateForm(info->frame,  "panes",  wargs,  nargs); 
XmStringCreate(label,  info->labelCharSet); 
SetArg(XmNlabelType,  XmSTRING); 

SetArg(XmNlabelString,  cs); 

XtCreateWidgetC’label",  xrnLabelGadgetClass,  panes,  wargs, 
nargs); 

XtCreateWidgetC’sep",  xmSeparatorGadgetClass,  panes,  wargs, 
nargs); 

create_selector(info,  panes,  "power",  power_select,  0,  0,"LO", 
PWR_LO,"M",  PWR_M,"HI",  PWR_HI,"PA", 

PWR_PA,0); 

create_selector(info,  panes,  "channel",  channel_select,  0, 0,"CUE", 
CUE,"MAN",  MAN,"1",  1,"2",  2,"3",  3,"4",  4,"5",  5,"6", 

6,0); 

create_selector(info,  panes,  "mode",  mode_select,  0, 0,"SC", 
SC,"FH",  FH,"FH-M",  FH_M,0); 
create_selector(info,  panes,  "function",  function_select,  0, 
0,"STBY",  STBY,"TST",  TST,"LD",  LD,"SQ  ON", 
SQ_ON,"SQ  OFF",  SQ_OFF,"RXMT",  RXMT,"REM", 
REM,"Z-FH",  Z_FH,"OFF",  FCTN_OFF,0); 
create_keypad(info,  panes,  "keypad"); 

create_selector(info,  panes,  "comsec",  comsec_select,  0,‘0,"PT", 
PT,"CT",  CT,"TD",  TD,"RV",  RV,"COM-Z",  COM_Z,0); 
create_selector(info,  panes,  "tc_ptt", 

ptt_select,positionCommander,  0,"",-l,"A",A,"B",B,"INT", 
INT,0); 

create_selector(info,  panes,  "Lptt",  ptt_select,  positionLoader, 
0,"",-l,"A",A,"B",B,"INT",  INT,0); 
create_selector(info,  panes,  "g_ptt",  ptt_select,  positionGunner, 
0,"",-l,"A",A,"B",B,"INT",  INT,0); 
create_selector(info,  panes,  "d_ptt",  ptt_select,  positionDriver, 
0,"",-l,"A",A,"B",B,"INT",  INT,0); 
create_selector(info,  panes,  position  ==  0  ?  "pttO" :  "ptt",ptt_select, 
0,  0,"",-l,"Talk",  A,0); 

create_selector(info,  panes,  "quit",  quit_select,  0,  0,"RUN", 
0,"PAUSE",  1,"QUIT",  2,0); 

XtManageChildren(widgets,  nwidgets); 

XtManageChild(panes); 

XtRealizeWidget(info->frame); 

XFlush(info->dpy); 

info; 

MOTIFP_INFOP  motif_pancl 
(name,  idx) 

XtToo  itInitializeO; 
sprintf(nu_buf,  "RIU  %d",  rp->r_riu); 

sprintf(ivis_buf,  "I VIS  %d",  riuTable[rp->r_riu].u_ivis_index[0]); 
sprintf(ivis_buf,  "no  I  VIS"); 
sprintf(riu_buf,  "no  RIU"); 
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sprintf(ivis_buf,  "no  IVIS"); 
sprintf(label,  "RT-1523-X  Radio  %s,  %s, 

%s",RadioIDToString(rp->r_radio_id),riu_buf,  ivis_buf); 
sprintf(geom_buf,  "+%d+%d",  100  -  20  *  position,  20  *  position); 
iInitXt(&argc,  argv,  label,  RadioIDToString(rp- 
>r_radio_id),panelTable  +  idx,  position,  ptt); 

Return:  info; 

Function  Definition:  motifp_input 
Arguments:  (info) 

Calls:  sprintf(fname,  "/simnet/data/sincgars/panel%d.state",info->fp  - 

panelTable); 

fopen(fname,  "r"); 
fscanf(f,  "%d\n",  &setting); 
fclose(f); 

XqButtonListSelectPos(w,  info->current_settings[i],  True); 
XqButtonListHilitePos(w,  info->current_settings[i]); 
XtAppNextEvent(info->app,  &event); 

XtDispatchEvent(&event); 

Function  Definition:  static  save_settings 
Arguments:  (info) 

Calls:  sprintf(fname,  "/simnet/data/sincgars/panel%d. state", 

info->fp  -  panelTable); 
fopen(fname,  "w"); 

fprintf(f,  "%d\n",  info->current_settings[i]); 
fclose(f); 

Function  Definition:  motifp_exit 

Call:  save_settings(fp->intemal.key_io.u.motif_info); 


4. 1.8.2  Motifp  CSU  Design 

The  motifp  CSU  is  a  set  of  X-windows  functions  which  replace  certain  controls.c 
functions  when  the  simulation  is  built  for  use  with  X-windows.  It  is  not  incorporated  into 
the  versions  used  at  Fort  Knox  or  Fort  Monmouth,  but  is  included  for  future  use. 


4.1.9  Network  CSU 

The  network  CSU  is  a  set  of  functions  designed  to  handle  the  sending  and  receiving  of 
simulation  network  data  on  the  Ethernet. 


4.1.9.1  Network  CSU  Design  Specification/Constraints 

Function  Definition:  void  InitSimNetwork 

Function  Definition:  SignalVariant  *AllocateBuffer 
Return:  buf; 

Function  Definition:  void  DeallocateBuffer 
Arguments:  (buf) 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Return: 

Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Call: 


void  saveSignalPDU 
(tp,  bu^) 

AllocateBufferO; 

bcopy((char  *)  bulp,  (char  *)  pdu,OFFSETA(SignalVariant,  data)+ 
bufp- >dataLen  gth) ; 

void  ReadPDUs 

Assc  .ReceivePDU(&buf,  &length,  &group,  &protocol, 
&primitive,  &originator,  &transID,  &respondent); 
AssocReceivePDU(assocHandle,  &buf,  &length,  &group, 

&protocol,  &primitive,  &originator,  &transID,  &respondent); 
fflush(astStream); 
exit(O); 

ProcessVehicleAppearancePDU(&(simPDU- 

>variant.appearance)); 

VehicleDeactivated(  VehiclelDtoIndex  (si  mPDU- 
>vanant.deactivateRsp.vehicleID)); 
ProcessStatusChangePDU(&(dataPDU->variant.statusChange)); 
Proce5sVehicleStatusPDU(&(dataPDU->variant.vehicleStatus)); 
ProcessTransmitterPDU(&(radioPDU->variant.transmitter)); 
ProcessSignalPDU(&(radioPDU->variant.signal)); 
ProcessAlertOperatorPDU(&(radioPDU->variant.alert)); 
ProcessrVISTransmitRequestPDU(&(ivisPDU- 
>variant.transmitRequest)); 

ProcessSignalPDUsO; 

int  VehiclelDtoIndex 
(vehiclelD) 

fprintf(stderr,  "VehiclelDtoIndex:  appearanceTable  fullNn"); 

exit(l); 

vidx; 

void  ProcessVehicleAppearancePDU 
(pdu) 

VehicleIDtoIndex(pdu->vehicleID); 

void  ProcessStatusChangePDU 
(pdu) 

void  ProcessVehicleStatusPDU 
(pdu) 

void  ProcessSignalPDU 
(pdu) 

VehicleIDtoIndex(pdu->radio.vehicle); 
saveSignalPDU (tp,  pdu); 

void  ProcessTransmitterPDU 
(pdu) 

VehicleIDtoIndex(pdu->radio.  vehicle); 
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Function  Definition: 
Arguments; 
Return: 

Return: 

Function  Definition: 
Call: 

Function  Definition: 
Calls: 

Return; 

Return: 

Function  Definition: 
Arguments: 
Return: 

Function  Definition: 
Arguents: 
Return: 

Function  Definition; 
Arguments; 
Return: 

Function  Definition: 
Arguments: 
Return: 

Return: 

Function  Definition: 
Call: 

Function  Definition: 
Arguments: 
Call: 

Return: 

Return: 

Calls: 


Return: 

Function  Definition: 
Arguments: 
Calls: 


int  EqualFH 
(hi Ip,  hi2p) 

0; 

1; 

void  init_add_noise 
pow(10.0,  -i/10.0); 

int  add_noise(a,  b) 

init_add_noise(); 

a; 

a  +  s_dBm_sum[d]; 

FH_to_S  C_noise 
(hip,  frequency,  power) 
power  -  31; 

FH_to_FH_noise 
(hipl,  hip2,  power) 
power  -  M ; 

SC_to_FH_noise 
(frequency,  hip,  power) 
power  -  31; 

SC_to_SC_noise 
(freql,  freq2,  power) 
power; 

power  -  5  *  (separation  +  6); 

desynchronize(rp) 

S  endRecei  verPDU  (rp) ; 

int  finishPDU 
(rp,  tp,  snr,  pdu) 
desynchronize(rp), 

1; 

0; 

riu_receive_data(&riuTable[rp->r_riu],rp-radioTable,tp,snr,pda- 

>data,size); 

simvads_data_frame(rp->r_voice_output); 

erf_receive_data(rp->r_fps,  tp,  snr,  (ERF_MSGP)  pdu->data,  size); 
simvads_data_frame(rp->r_voice_output); 

simvads_save_frame((short  *)  pdu->data,size,rp->r_voice_output); 

0; 

void  Receives  C 

(rp) 

add_noise(noise_power,FH_to_SC_noise(&tp- 
>t_hopinfo,frc*.quency,received_power)); 
add_noise(noise_power,SC_to_SC_noise(tp- 
>t_frequency,frequency,received_power)); 
add_noise(noise_power,  received_power); 
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Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Call: 

Function  Definition: 
Calls: 


desynchronize(rp); 

finishPDU(rp,  sync_tp,  sync_snr,  pdu); 

void  ReceiveSCSync 

(rp) 

add_noise(noise_power,FH_to_SC_noise(&tp- 
>t_hopinfo, frequency  ,received_power)); 
add_noise(noise_power,SC_to_SC_noise(tp- 
>t_frequency,frequency,received_power)); 
add_noise(noise_power,  received_power); 
add_noise(noise_power,  max_power); 

SendReceiverPDLJ(rp); 

Send  ReceiverPDU  (rp) ; 

void  ReceiveCUE 
(ip) 

add_noise(noise_power,FH_to_SC_noise(&tp- 
>t_hopinfo, frequency, received_power)); 
add_noise(noise_power,SC_to_SC_noise(tp- 
>t_frequency, frequency  ,received_power)); 
add_noise(noise_power,  max_power); 
add_noise(noise_power,  received_power) ; 
fpt_receive_cue(rp->r_fps); 

void  ReceiveFH 

(rp) 

add_noise(noise_power,SC_to_FH_ncise(tp->t_frequency,&rp- 

>r_hopinfo,received_power)); 

add_noise(noise_power,FH_to_FH_noise(&tp->t_hopinfo,&rp- 

>r_hopinfo,received_power)); 

add_noise(noise_power,FH_to_FH_noise(&tp->t_hopinfo,&rp- 

>r_hopinfo,received_power)); 

desynchronize(rp); 

void  ReceiveFHSync 

(rp) 

add_noise(noise_power,SC_to_FH_noise(tp- 
>t_frequency,hopinfo,received_power)); 
add_noise(noise_power,FH_to_FH_noise(&tp- 
>t_hopinfo,hopinfo,received_power)); 
add_noise(noise_power,  received_;  )wer); 
add_noise(noise_power,  max_power); 

SendReceiverPDU(rp); 

resetTransmi  ssions 
DeallocateBuffer(pdu); 

ProcessSignalPDUs 

ReceiveCUE(rp); 

simvads_noise_frame(rp->r_voice_output); 

ReceiveSCSync(rp); 

ReceiveFHSync(rp); 

ReceiveSC(rp); 
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Function  Definition: 
Arguments: 
Call: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 

Function  Definition: 
Arguments: 
Calls: 


ReceiveFH(rp); 

resetTransmissionsO; 

void  ProcessAlertOperatorPDU 
(pdu) 

alert_operator(rp); 

void  ProcessIVISTransmitRequestPDU 
(pdu) 

void  SetupRadioPDU 
(pdu,  kind) 

void  SetupSimulationPDU  (pdu,  kind) 

void  SetupIvisPDU 
(pdu,  kind) 

void  SendTransmitterPDU 
(rp,  periodic) 

fprintf(astStream,  "SendTransmitterPDU:  AssocSendDatagram 
%s\n",AssocError()); 

fprintf(astStream,  "SendTransmitterPDU:  AssocSendDatagram 
%s\n",AssocError()); 

void  SendReceiverPDU 

(rp) 

fprintf(astStream,  "SendReceiverPDU:  AssocSendDatagram 
%s\n ",  AssocErrorO ); 

fprintf(astStream,  "SendReceiverPDU:  AssocSendDatagram 
%s\n",  AssocErrorO); 

void  SendSignalPDU 

(rp,  speaker,  encoding,  synchronization,  duration,  bitcount) 
fprintf(astStream,  "SendSignalPDU:  AssocSendDatagram 
%s\n",  AssocErrorO); 
net_current_time(assocHandle); 

fprintf(astStream,  "SendSignalPDU;  AssocSendDatagram 
%s\n ",  AssocErrorO); 

VehicleIDtoIndex(siVar. radio,  vehicle) ; 
saveSignalPDU(tp,  &siVar); 

update_transmit_power(rp->r_fps,  synchronization  !=  syncEOM); 

void  SendIntercomPDU 

(vp,  speaker,  encoding,  duration,  bitcount) 

net_current_time(networkInterface); 

net_current_time(assocHandle); 

void  FlushPDUs 

void  SendVAPDU 
(vehiclelD,  location,  marking) 
net_current_time(networkInterface); 
net_current_time(assocHandle); 
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Function  Definition: 
Calls: 


Function  Definition: 

Function  Definition: 
Calls: 


Return: 


Calls: 


Return: 

Call: 

Return: 

Call: 


fprintf(astStream,  "SendVAPDU:  AssocSendDatagram 
%s\n",AssocError()); 

network_histogram_show 

RprintfC'Histogram  of  PDUs  received  per  tick:\n"); 

Rprintf("%d\f’,  i); 

Rprintf(">%d\n",  PDUS_PER_TICK_HISTOGRAM_SIZE  -  2); 
Rprintf("%d\t",  pdus_per_tick_histogram[i]); 

Rprintf("%d\n",  pdus_per_tick_histogram 

[PDUS_PER_TICK_HISTOGRAM_SIZE  -  1]); 

network_histogram_zero 

network_show_cmcstats 
net_stat_string(i,  s); 

Rprintf("%s  %ld\n",  s,  stats[i]); 
net_zero_statistics(networkInterface); 
net_zero_statistics(assoc  Handle); 
net_getaddr(networkInterface,  &na); 
net_getaddr(assocHandle,  &na); 
net_addr_bin_to_str(&na,  eaddr); 
net_addr_format_convert(eaddr,  print_eaddr); 

RprintfC'ethemet  address:%s\n",  print_eaddr); 

(networkinterface); 

(assocHandle); 

siVar.data; 

fprintf(astStreani,  "%s  to  IVIS  %s  timed- 

out\n",param,SimulationAddressToString(*respondent)); 
fprintf(astStream,  "rt_receive_to_ivis:  size  %d  >  %d\n",size, 
maxrVISMessageSize);exit(l); 

bcopy((char  *)  msg,  (char  *)  &irBuffer->variant.receive.message, 
size); 

fprintf(astStream,  ”rt_receivr'_.to,.  ivis:  A^''ocSendT^';^r.s.^i 
%s\n",AssocEtTorC); 

fprintf(astStreain,  "r[_re\.>onse_ioJvi,5:  AssocSendTranract 
%s\n",Ass<:  cErrcrO); 

fprintf(astStrear!  t,  "rt_uansmit_data:  size  %d  > 
%d\n",size,MAX_DATA_BYTES); 
exit(l); 

bcopy(dg,  siVai’.data,  size); 

SendSignalPDU  (&radioTable[radioNumber]  ,speakerRIU, 
signalData,synchronization,tickInterval,BITS(char)  *  size); 
FlushPDUsQ; 

bcopy((char  *)  erf_msg,  siVar.data,  size); 
SendSignalPDU(rp,speakerERF,signalERF,synchronization,tickInt 
erval,BITS(char)  *  size); 

FlushPDUsQ; 

sprintf(buf[buf_idx],  "%d/%d”,  addr.site,  addr.host); 
buf[buf_idx]; 

sprintf(buf[buf_idx],  "%d/%d/%d",  vid. simulator. site, 
vid.simulator.host,vid.  vehicle); 
buf[buf_idx]; 

sprintf(buf[buf_idx],  "%d/%d/%d/%d",  rid. vehicle. 
simulator.site,rid.  vehicle. simulator.host, 
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rid.vehicle.vehicle,  rid.radio); 
Return;  buf[buf_idx]; 


4.1.9.2  Network  CSU  Design 

The  network  CSU  consists  of  an  initialization  function  and  a  polling  function. 


4.1.10  Panelint  CSU 

The  panelint  CSU  supports  the  front  panel  interface.  It  controls  initialization  of  the  IDC 
(inteactive  device  controller)  board,  which  is  responsible  for  sending  messages  to  the 
simulation  host  about  changes  in  the  front  panel.  The  panelint  CSU  also  contains  the 
front  panel  polling  routine,  which  is  invoked  by  the  main  loop. 


4.1.10.1  Panelint  CSU  Design  Specification/Constraints 

Function  Definition:  InitIDCs 

Calls:  mem_assign_shared_memory() 

idc_init() 
controIs_init(); 

Function  Definition:  Panelsinit 
Arguments:  (radio) 

Call:  set_update_flag(fp,TRUE); 

Function  Definition:  CheckFrontPanels 
Calls;  check_delay(rp->r_fps) 

motifp_input(rp->r_fps*>intemal.key_io.u.motif_info) 

update_fp_power(rp->r_fps,rp->r_rcvd_power,FALSE) 

set_updaTe_flag(rp->r_fps,FALSE) 

check_blink(rp->r_fps) 

check_beep(rp->r_fps) 

check_reset(rp->r_fps); 

Function  Definition:  reset_fp 

Call:  reset_fps(rp->r_fps) 


4.1.10.2  Panelint  CSU  Design 

A  change  in  tiie  front  panel  switch  causes  the  IDC  board  to  send  a  message  to  the 
simulation  host,  which  invokes  the  appropriate  function  in  controls.c. 


4.1.11  Param  CSU 

The  param  CSU  controls  aspects  of  the  radio  simulator’s  behavior. 
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4.1.11.1  Param  CSU  Design  Specification/Constraints 


Function  Definition: 
Arguments: 
Return: 

Return: 


ConvertSimulationAddress 
(address,  str) 

-1 


0; 


Function  Definition:  void  ProcessParameters 
Arguments:  (filename) 

Calls:  exit(i) 

fprintf(stderr,  "ProcessParameters:  AssocGetSimAddress  failed  -- 
\"%s\"\n",  AssocErrorO) 
exit(l) 
clear_tod(fp) 
clear_channels(fp) 
clear_lockouts(fp) 
clear_comsec(fp) 
clear_transec(fp) 

ReportError(missingParameter) 

ReportError(missingParameter) 

ReportError(badRange,  "Radio  number", radioNumber,  0, 

M  AX_LOCAL_RADIOS  - 1 ) 

ReponErrorC'RADIO  parameter  must  precede  ATTACH") 
ReponErrorC'Duplicate  ATTACH  parameter") 
ReponError(missingParameter) 

ReportError(missingParameter) 

ReponError(missingParameter) 

ReponErrorC'Bad  marking  char  set:  %c",  chr) 
ReportError(missingParameter) 

ReportErrorC'Bad  marking  char  set:  %c",  chr) 
ReportError(missingParameter) 

ReportErrorC'Incorrect  attachment  method:  %s",  str) 
ReportError(missingParameter) 

ReportError(missingParameter) 

ReportError(missingParameter) 

ReportError(missingParameter) 

ReportEiror(missin3Parameter) 

ReportError(badRange,  "Radio  number",radioNumber,  0, 
MAX_LOCAL_RADIOS  - 1 ) 

ReportErrorC'Duplicate  RADIO  parameter") 
ReportError(missingParameter) 

ReportError(missingParameter) 

ReportError(bad  VoiceChannel) 
ReportError(badKeywordParameter,  str) 
ReportError(missingParameter) 

ReportErrorC'RADIO  parameter  must  precede  PRESET") 
ReportError(missingPara  meter) 

ReportError(badRange,  "Channel  number" ,channelNumber,  0, 
NCHANNELS-1) 

ReportError(baaRange,  "Frequency",ffequency,  30000,  87750) 
ReportErrorC'PRESET  frequency  not  a  multiple  of  250") 
ReportError(missingParameter) 

ReponError(badRange,  "Channel  number" ,channelNumber,  1,  6) 
ReportError(badRange,  "Hopset",hopset,  1,  999) 
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ReportEiTor(missingParameter) 

ReportEiTor(badRange,  "Lockout  number" ,lockoutNumber,  1, 
numberFHLockouts) 

ReportEiTor(badRange,  "Lockout", lockout,  1, 999) 
ReportError(missingParameter) 

ReportError(badRange,  "Channel  number" ,channelNumber,  0,  6) 
ReportError(badRange,  "Comsec",  comsec,  1, 999) 
ReportError(missingParameter) 

ReportError(badRange,  "Channel  number" ,channelNumber,  1,  6) 
ReportError(missingParameter) 

ReportError(badRange,  "Transec",  transec,  1,  999) 
ReportError(badKeywordParameter,  str) 
ReportError(missingParameter) 

ReportError("Duplicate  RIU  parameter") 
ReportError(missingParameter) 

ReportError(badRange,  "Radios/RIU",  i,  0, 
MAX_RADIOS_PER_RIU) 

ReportError(missingParameter) 

ReportError(badRange,  "Radio  number" ,radioNumber,  0, 
MAX_LOCAL_RADIOS-l) 

ReponErrorC'RADIO  parameter  must  precede  VEHICLE") 
ReportError(missingParameter) 

ReportError(badRange,  "IVISes/RIU",  i,  0, 
MAX_IVISES_PER_RIU) 

ReponError(missingParameter) 

ReportError(badlvisNumber) 

ReponError("IVIS  parameter  must  precede  RIU") 
ReportError(missingParameter) 

ReponError("Duplicate  FVIS  parameter") 
ReponError(missingParanieter) 

ReportError(badAddress) 

ReportError(missingParameter) 

ReportError(missingParameter) 

ReportError(bad  V  ehicleNumber) 

ReportError("VEHICLE  parameter  must  precede  STATION") 
ReportError(missingParameter) 

ReportError("DupUcate  station  parameter") 

ReportError(bad  V  oiceChannel) 

ReportError(pttConfl  ict) 

ReportError(missi  n  gParameter) 

ReportError(miss  ingParameter) 

ReportError(bad  VehicleNumber) 

ReportErrorC'Duplicate  VEHICLE  parameter") 
ReportError(missingParameter) 

ReportError(mi  ssingParameter) 

ReportError(badRange,  "Radio  number",0,  radioNumber, 
1VIAX_L0CAL_RADI0S- 1 ) 

ReportErrorC'RADIO  parameter  must  precede  VEHICLE") 
ReportErrorC’Duplicate  VEHICLE  parameter") 
ReportError(badKeywordParameter,  str) 

Re  portError(mi  ssing  Parameter) 

ReportError(badVoiceChannel) 

ReportErrorC'Duplicate  VOICECHANNEL  parameter") 
sprintf(vc->s_name,  "sv%x:",  voicechannelNumber) 
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sprintf(vc->s_name,  "sv%x",  voicechannelNumber) 
sv_get_duration(SIXTEEN_KBITS_PER_SECOND) 
sv_get_bitcount(SIXTEEN_KBITS_PER_SECOND) 
sv  get_duration(TfflRTYTWO_KBITS_PER_SECOND) 
sv_get_bjtcount(TfflRTYTWO_KBITS_PER_SECOND) 
sv  get_duration(SIXTEEN_KBITS_PER_SECOND) 
svIget_bitcount(SIXTEEN_KBITS_PER_SECOND) 
ReportErrorC'Unknown  voice  encoding") 
ReportErrorC'Parameter  keyword  not  recognized") 
ReportError("Line  contains  extraneous  information") 

Function  Definition:  static  int  ParseWord 
Arguments:  (pf,  str) 

Return:  0; 

Return;  1; 


Function  Definition:  static  void  ReportError 
Arguments:  (va_alist) 

Calls:  va_start(args) 

va_arg(args,  char  *) 
vfprintf(stderr,  fmt,  args) 
va_end(args) 
fprintf(stderr,  "\n") 
getc(f) 
ungetc(ch,  f) 


4.1.11.2  Param  CSU  Design 

The  param  CSU  reads  a  parameter  file  (/simnet/data/sincgars/pars)  at  startup.  The 
parameter  file  contains,  for  example,  a  definition  of  the  number  and  type  of  radios 
attached  to  a  given  simulation  host. 


4.1.12  Radioidc  CSU 

The  radioidc  CSU  initializes  the  connection  between  the  radio  simulator  software  and 
libidc,  the  idc  librarj',  which  stores  the  functions  for  communications  with  the  IDC  board. 


4.1.12.1  Radioidc  CSU  DCiign  Specification/Constraints 

Function  Definition:  idc_get_num_idcs 
Call:  return  (NUMJDCS); 

Function  Definition:  idc_array_init 

Function  Definition:  void  idc_veh_spec_init 


4.1.12.2  Radioidc  CSU  Design 
Radioidc  is  a  single  initialization  function. 
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4.1.13  Radiomem  CSU 

The  radiomem  CSU  is  a  set  of  data  structures  connecting  DDC  boards  to  radio  simulator 
software. 

4.1.13.1  Radiomem  CSU  Design  Specification/Constraints 
Function  Definition:  mem_assign_other_ptrs 

4.1.13.2  Radiomem  CSU  Design 

Radiomem  is  a  single  function  for  mapping  IDC  boards  to  radio  simulator  software. 

4.1.14  Riu_bufCSU 

The  riu  buf  CSU  defines  data  buffers  used  in  the  riu  simulation. 


4.1.14.1  Riu  buf  CSU  Design  Spedfication/Constraints 


Function  Defmicion: 
Arguments: 
Calls: 


Return: 


PUBLIC  RIU_MSGPriu_buf_allocate 
(size) 

fprintf(stderr,  "riu_buf_allocate:  Out  of  memoryXn"); 
exit(l) 

bzero(bf->m_data,  size) 
fprintf(astSrt''''’,m,  "riu_buf_allocate:  msg 
.\n",riu_buf_outstanding,  bf) 
bf 


Function  Definition:  PUBLIC  void  riu_buf_deallocate 
Arguments:  (bf) 

Calls:  fprintf(astStream,  "riu_buf_dealloca:  msg 

%d(S)%6x\n",riu_buf_outstanding,  bf) 
FREE(bf) 


4.1.14  2  Riu_buf  CSU  Design 

Riu_buf  has  two  functions,  allocation  and  deallocation. 


4.1.15  Riu_tmr  CSU 

The  riu_tmr  CSU  cop*to1s  the  riu  timing  functions. 

4.1.15.1  Riu_tmr  CSU  Design  Specification/Ccnstraints 
Function  Definition:  riu_timer_init 
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Function  Definition:  riu_timer_periodic 
Arguments:  (elapsed) 

Function  Definition:  riu_timer_cancel 

Arguments:  (if_what,  what,if_argl,  argl,if_arg2,  arg2,if  _arg3, 

arg3,if_arg4,  arg4) 


Function  Definition:  riu_timer_delay_ 

Arguments:  (delay,  what,  nargs,  argl,  arg2,  arg3,  arg4) 

Calls:  fprintf(stderr,  "riu_timer_delay:  ran  out  of  memory\n"); 

exit(l); 


4.1.15.2  Riu  mr  CSU  Design 

Riu_tmr  is  called  by  riu.c. 


4.1.16  Riu  CSU 

The  riu  CSU  contains  the  actual  riu  simulation  functions.. 


4.1.16.1  Riu  CSU  Design  Specification/Constraini  s 

Function  Definition:  riu_assert_fail 
Arguments:  (msg,  line,  file) 

Calls:  fprintf(astStream,  "riu_assert  failed  at  LINE  %d,  FILE  %s: 

%s\n",line,  file,  msg) 

exit(l) 

Function  Definition:  riu_print_msg 

Arguments:  (riu,  radio,  label,  msg,  tag) 

Calls:  riu_radio_n(riu,  radio) 

sprintf(more,  "  src  %s  ber=%8f ',  RadioIDToString(id),  msg- 
>m_ber) 

fprintf(astStream,"%*s:  riu  %d  radio  %d  %d 

bytes%s%s%*s%s.\n",RIU_PRINT_LABEL_WIDTH, 
label,riu  -  riuTable,  radio_n,  msg->m_bytes,more,tag  != 
NULL  ?  "\n" :  "",tag  !=  NULL  ? 

RIU_PRINT_LABEL_WIDTH  +  2  :  0,"",tag  !=  NULL  ?  tag  : 


Function  Definition:  riu_print_pkt 

Arguments:  (riu,  radio,  label,  pkt,  src,  power) 

Calls:  riu_radio_n(riu,  radio) 

sprintf(frag,  "  frg  %d  of  %d",  pkt->f_fragment+l,  pkt->f_frags) 
sprintf(xmitter, ''  src  %s  %ddBm",  RadioIDToString(id),  power) 
fprintf(astStream,  "%*s:  riu  %d  radio 

%d%13s%s\n",RIU_PRINT_LABEL_WIDTH,  label,riu  - 
riuTable,  radio_n,  frag,  xmitter) 
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Function  Definition:  riu_test 

Arguments;  (riu,  serial,  sender,  radio_n) 

Calls:  stmcpy(pdu->message.messageID.originator.callSign.text, 

"TESTX’',roaxIVISCallSignLength) 
riu_from_ivis(riu,  riu->u_radio_index[radio_n],  pdu) 
riu^tjrner_delay4(3000  +  riu_random_delay(7000),riu_test,  riu, 
serial+l,  sender,(radio_n  +  1)  %  riu->u_num_radios) 

riu_init 
(riu) 

riu_timer_init() 

bzero((char  *)  s_zero_bits,  sizeof(BITARRAY)) 
SETBIT(s_one_bits,  i) 

CLRBIT(s_zero_bits,  i) 

OFFSET(RIU_Datagram,  type) 

OFFSET(RIU_Datagram,  sender) 
riu_timer_delay4(3(W0,  riu_test,  riu,  0,  &radioTable[riu- 
>u_radio_index[0]].r_radio_id.vehicle,  0) 
riu_zero(riu) 

Function  Definition:  riu_statistics 
Arguments;  (argc,  argv) 

Calls:  RprintfC'bad  riu  index;  must  be  0  <=  idx  <=  %d\n",  MAX_RIUS- 

1) 

RprintfC'RIU  %d  does  not  exist.\n",  argv[0]) 

RprintfC'Statistics  for  RIU  %d\n",  argv[0]) 

RprintffVAttached  to  radios:") 

Rprintf("  none") 

Rprintf("  %d",  riu->u_radio_index[i]) 

Rprintf(".\n") 

Rprintf("\t  Attached  'o  IViSes:") 

Rprintf("  none") 

Rprintf("  %d",  riu->u_ivis_index[i]) 

Rprintf(".\n") 

Rprintf("\tConnection  from  %s,  serial  #%d,  at  simulation  time 
%d.\n", 

VehicleIDToString(conn->c_remote), 

Rprintf("\t%8d  messages  from  IVIS.Xn",  riu->u_msgs_ffom_ivis) 
Rprintf("\t%8d  messages  to  IVIS.Xn",  riu->u_msgs_to_ivis) 
Rprintf("\t%8d  complete  transmissions.Xn",  riu->u_transmissions) 
Rprintf("\t%8d  transmitted  fragments .\n",  riu- 
>u_transmitted_fragments) 

Rprintf("\t%8d  received  fragments.Xn",  riu- 
>u_received_fragments) 

Rprintf("\t%8d  retransmissions.Xn",  riu->u_retransmissions) 
Rprintf("\t%8d  transmission  preemptions.Xn",  riu->u_preemptions) 
Rprintf("\t%8d  reassembly  failures.Xn",  riu- 
>u_reassembly_failures) 

Rprintf("\t%8d  messages  with  errors.Xn",  riu- 
>u_garbled_receptions) 

Rprintf("\t%8d  duplicates  received.Xn",  riu->u_duplicates) 

Function  Definition:  riu_zero 
Arguments:  (riu) 


Function  Definition: 
Arguments: 
Calls: 
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Function  Definition: 
Call; 

Function  Definition: 
Arguments: 
Return: 

Return: 

Function  Definition: 
Arguments: 
Calls: 

Return: 

Function  Definition: 
Arguments; 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


riu_zero_statistics 

riu_zero(riu) 

riu_radio_n 
(riu,  radio) 
radio_n 
-1 

riu„random_delay 

(range) 

double  drand48() 
delay 

riu_receive_data 

(riu,  radio,  source,  snr,  data,  size) 

riu_radio_n(riu,  radio) 

fprintf(astStream,  "riu_receive_data:  radio  not  attachedSn") 
exit(l) 

riu_print_pkt(riu,  radio,  "riu_receive_data",pkt,  source,  snr) 
fprintf(astStream,  "%*s:  reassembly 

failure\n",RIU_PRINT_LABEL_WIDTH,  "liu.receive.data") 
riu_buf_deallocate(msg) 

riu_buf_allocate(pkt->f_ffags  *  RIU_PKT_SIZE) 
fprintf(astStream,  "%*s:  reassembly 

faUure\n",RIU_PRINT_LABEL_WE)TH,  "riu_receive_data") 
fprintf(astStream,  "%*s:  reassembly 

faUure\n",RIU_PRINT_LABEL_WE)TH,  "riu_receive_data") 
riu_buf_deallocate(msg) 

fprintf(astStream,  "riu_receive_data:  incorrect  packet  sizeVi") 
exit(l) 

fprintf(astStream,  "riu_receive_data:  Message  too  big\n") 
exit(l) 

bcopy(pkt->f..data,  dp  +  bytes_rcvd,  pkt->f_bytes) 

riu_receive_end 
(riu,  radio,  msg) 

riu_print_msg(riu,  radio,  "riu_receive_end",  msg, "unattached") 

riu_buf_deallocate(msg) 

riu_corrupt(m£g) 

FREE(detected_error) 

riu_print_msg(riu,  radio,  "riu_receive_end",  msg, "possible  ACK 
w/errors. ..  dropped ") 
riu_buf_deallocate(msg); 

FREE(detected_error) 

riu_.print_msg(riu,  radio,  "riu_receive_end",  msg,"emor  in 
sender.. .dropped") 
riu_buf_deallocate(msg); 
riu_find_remote(riu,  dg->sender) 
riu_merge(conn,  msg,  detected_error); 

riu_print_msg(riu,  radio,  "riu_receive_end",  msg, "with  errors  after 
merging") 

riu_print_msg(riu,  radio,  "riu_receive_end",  msg, "with  errors, 
merged  successfully") 
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Function  Definition; 
Arguments: 
Calls: 


Function  Definition; 
Arguments: 
Call; 

Function  Definition: 
Calls; 


Function  Definition: 
Arguments; 
Return: 

Function  Definition: 
Arguments: 
Call: 

Return: 

Call: 

Return: 

Function  Definition: 
Arguments: 
Calls: 


Return: 


riu_print_msg(riu,  radio,  "riu_receive_end",  msg,"ACK") 

riu_ack_to_ivis(riu,  radio) 

riu_buf_deallocate(msg) 

riu_find_remote(riu,  ((RIU_DatagramP)  msg->m_data)->sender) 
riu_flush_merge(conn) 

sprintf(tag,"serial  #%d  to  IVIS  %s(2)%s",dg->serialNumber, 
VehicleIDToString(local),SimulationAddressToStrin 
g(to)) 

riu_print_msg(riu,  radio,  "riu_receive_end",  msg,  tag) 
rt_receive_to_ivis(riu,  radioT able[radio]  .r_radio_id,dg->network, 
&dg->u.message.message,dg->u.message.message. length) 
riu_print_msg(riu,  radio,  "riu_receive_end",  msg,"duplicate") 
riu_transmit_ack(riu,  radio,  conn->c_remote,  local,  dg->network, 
dg->serialNumber) 
riu_buf_deallocate(msg) 

riu_from_ivis 
(riu,  radio,  pdu) 
riu_ack_to_ivis(riu,  radio); 

riu_buf_allocate(size  +  OFFSET(RIU_Datagram,  u.message)) 
bcopy((char  *)  pdu,  (char  *)  &dg->u. message,  size) 
sprintf(tag,  "serial  #%d  from  IVIS  %s",dg- 

>serialNumber,RadioIDToString(pdu->radio)) 
riu_print_msg(riu,  radio,  "riu_from_ivis",  msg,  tag) 
riu_transmit_start(riu,  radio,  msg) 

riu_update_ber 
(riu,  radio_n) 

riu_receive_end(riu,  riu->u_radio_index[radio_n],  msg) 
riu_tick 

riu_update_ber(riu,  radio_n) 
riu_timer_periodic(tickInterval) 

double  tint 

(d) 

floor(d  +  0.5) 

riu_corrupt 

(msg) 

double  drand48() 

NULL 

SETBIT(bits,  'which_one) 
bits 

riu_merge 

(conn,  msg,  detected_error) 

!TSTBIT(detected_error,  i) 

!  TS  TBIT(&conn->c_merge_statu  s,  i) 
CLRBIT(&conn->c_merge_status,  i) 

FREE(detected_error) 

riu_buf_deallocate(msg) 

NULL 
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Call: 

Return: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Arguments: 
Calls: 


riu_flush_merge(conn) 

msg 

riu_flush_merge 

(conn) 

riu_cancel_message 
(riu,  msg) 

riu_timer_cancel(true,  riu_retry,true,  (long)  riu, false,  0,true,  Qong) 
msg,false,  0) 

riu_timer_cancel(true,  riu_transmit_start,true,  (long)  riu, false, 
0,true,  (long)  msg,false,  0) 

riu_timer_cancel(true,  riu_transmit_continue,true,  (long)  riu,false, 
0,true,  (long)  msg,false,  0) 
riu_buf_deallocate(msg) 

riu_ack_to_ivis 
(riu,  radio) 

fprintf(astStream,  "%*s:  ser#=%d 

sendei^%s\n",RIU_PRINT_LABEL_WIDTH, 

"riu_ack_to_ivis",ack.serialNumber, 

RadioIDToString(ack.radio));rt_response_to_ivis(riu,  &ack) 
riu_cancel_message(riu,  msg) 
riu_cancel_message(riu,  riu->u_transmit_msg[i]) 

Priu_transmit_ack 

(riu,  radio,  sender,  recipient,  network,  serialNumber) 
fprintf(astS cream,  "*s:  ser#=%d  sender=%s  to  recipient 

=%s\n",RIU_PRINT_LABEL_WIDTH,"riu_transmit_ack", 

serialNumber,IVIS_SystemIdentifierToString(recipient), 

IVIS_SystemIdentifierToString(sender)) 

riu_buf_allocate(size) 

(RIU_DatagramP)  msg->m_data 

riu_timer_delay3(riu_random_delay(RIU_DELAY_RANGE), 
riu_transmit_start,  riu,  radio,  msg) 

riu_transmit_complete 
(riu,  radio,  msg,  status) 
iriu_radio_n(riu,  radio) 

key_radio(&radioTable[radio],  0,  speakerUnknown) 
riu_timer_delay3(riu_random_delay(RIU_DELAY_RANGE), 
riu_transmit_start,  riu,  radio,  msg) 
riu_buf_deallocate(msg) 

riu_timer_delay3(s_retry_interval,  riu_retry,  riu,  radio,  msg) 
riu_ack_to_ivis(riu,  radio) 

riu_tran  smi  t_co  n  tin  ue 
(riu,  radio,  msg) 

key_radio(&radioTable[radio],  R_KEYED_DATA,  speakerRIU) 
rt_transmit_data(radio,  (char*)  &pkt,  sizeof(pkt),  syncPreamblel) 
riu_timer_delay3(ticklnterval,  riu_transmit_continue,  riu,  radio, 
msg) 

bcopy(dp  +  bytes_sent,  pkt.f_data,  pkt.f_bytes) 
riu_print_pkt(riu,  radio,  "riu_transmit_continue",&pkt,  NULL,  0) 
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fprintf(astStream,"riu_transmit_continue:  m_fragments  beyond 
m_frags\n") 
exit(l) 

rt_transmit_data(radio,  (char  *)  &pkt,  sizeof(pkt),  syncNormal) 
riu_timer_delay3(ticklnterval,  riu_transmit_continue,riu,  radio, 
msg) 

rt_transmit_data(radio,  (char  *)  &pkt,  sizeof(pkt),  syncEOM) 
riu_timer_delay4(ticklnterval,  riu_transmit_complete,riu,  radio, 
msg,  TRANSMIT_OK) 

riu_transmit_complete(riu,  radio,  msg,  TRANSMIT_PREEMPT) 

Function  Definition 
Arguments: 

Calls: 


riu_transmit_start 
(riu,  radio,  msg) 
riu_radio_n(riu,  radio) 

riu_timer_delay2(ticklnterval,  riu_transmit_start,  radio,  msg) 
sprintf(bf,  "transmission  %d",  msg->m_transmit_count+l) 
riu_print_msg(riu,  radio,  "riu_transmit_start",  msg,  bf) 
riu_transmit_continue(riu,  radio,  msg) 


Function  Definition: 
Arguments: 
Calls: 


riu_retry 
(riu,  radio,  msg) 

riu_print_msg(riu,  radio,  "ri  i_retry",  msg, 
"retransmit  limit  reached") 
riu_ack_to_ivis(riu,  radio) 
riu_transmit_start(riu,  radio,  msg) 


Function  Definition: 
Arguments: 
Return: 

Call: 

Return: 


riu_find_remote 
(riu,  remote) 
conn 

riu_flush_merge(conn) 

conn 


4.1.16.2  Riu  CSU  Design 

Riu  is  invoked  by  functions  in  network.c. 


4.1.17  Rtu  CSU 

The  rtu  CSU  is  not  used  in  the  Fort  Knox  and  Fort  Monmouth  versions.  It  provides 
certain  UNIX  functions  needed  by  the  radio  simulation  that  are  not  available  when  the 
software  is  built  for  other  computer  systems. 


4.1.17.1  Rtu  CSU  Design  Specification/Constraints 


Function  Definition: 
Arguments: 
Call: 

Return: 

Calls: 

Return: 


setpri 

(pri) 

sv_get_astpri  (); 
(set_pri); 
sc_unlock  (); 
scjock  0; 
ret_pri; 
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Function  Definition:  getopt 
Return:  EOF; 

Return:  retval; 

Return:  retval; 

Return:  retval; 

Calls:  fprintf  (stderr,"%s:  option  requires  argument  --  %c\n", 

argv[0],argptr[l]); 

Remm:  '?'; 

Return:  '?'; 

Function  Definition:  double  drand48 
Call:  rand  (); 

Return:  imed  /  base; 


4.1.17.2  Rtu  CSU  Design 

Rtu  is  a  collection  of  functions  normally  found  on  UNIX  systems. 


4.1.18  Simvads  CSU 

The  simvads  CSU  contains  routines  that  handle  the  simvad  (voice  I/O)  boards. 


4.1.18.1  Simvads  CSU  Design  Specification/Constraints 

Function  Definition:  simvads_init 

Arguments:  (handler,  busy_filename,  noise_filename) 

Calls:  printf  ("simvads_init:opening  busy  file  %s\n",  busy_filename) 

noise_ffame_buffer[idx][0],  idx) 
close(fd) 

printf  ("simvads_init:about  fopen  record  file\n") 
record_file  =  fopen  ("record",  "w'") 
bzero(simstats,  sizeof(struct  simstats)  * 
MAX_VOICE_CHANNELS) 

Return:  (-1) 

Return:  (0) 


Function  Definition:  broadcast_vc 
Arguments:  (vc,  pp,  rp,  real) 

Calls:  SendSignalPDU(rp,  vc->s_crew_station,  vc->s_encoding,rp- 

>r_keycd  ==  0  ?  syncPreamblel  :real  ?  syncNormal 
:syncPreamble4,vc->s_duration,  vc->s_bitcount)key_radio(rp, 
R_KEYED_VOICE,  speaker) 

SendSignalPDU(rp,  vc->s_crew_station,  vc->s_encoding, 
syncEOM,vc->s_duration,  vc->s_bitcount) 
key_radio(rp,  R_KEYED_END,  speaker) 
key_radio(rp,  0,  speakerUnknown) 
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Function  Definition: 
Calls: 


Function  Definition: 
Call: 


Function  Definition: 
Arguments: 
Call: 


Function  Definition: 
Arguments: 
Call: 


Function  Definition: 
Arguments: 


Function  Definition: 
Arguments: 
Call; 


Function  Definition: 
Calls: 


Function  Definition: 
Calls: 


simvads_service 

GetBufferO 

bcopy(busy_frame  buffer[tickCount  % 

BUS Y_SIGNAL_FRAMES] .buffer,  28  *  sizeof(short)) 
main_need_simvads_restart() 
broadcast_vc(vc,  pp,  rp,  got_frame) 
fwrite(buffer,  28, 2,record_file) 
fclose(record_file) 
broadcast_vc(vc,  pp,  rp,  got_frame) 

SendIntercomPDU(vp,  vc->s_crew_station,  vc->s_encoding,vc- 
>s_duration,  vc->s_bitcount)  . 
broadcast_vc(vc,  pp,  rp,  got_frame) 

FlushPDUsO 

fprintf(astStream,  "%d  %s==>%s\n",  i,  £tates[Ostate],  states[vc- 
>s_frame_state]) 


simvads_uninit 

simvads_stop() 


simvads_really_save_ffame 
(type,  frame,  size,  channel) 

bcopy(ffame,  vc->s_frames[vc->s_store_index].ffame_buffer,  size 
<=  FRAMEBUFFER_SIZE  ?  size  :FRAMEBUFFER_SIZE) 


simvads_save_ffame 
(frame,  size,  channel) 

simvads_really_save_frame(l,  frame,  size,  channel) 


simvads_data_frame 

(channel) 


simvads_noise_frame 

(channel) 

simvads_really_save_frame(3,  noise_frame_buffer[frame],28  * 
sizeof(short),  channel) 


simvads_stop 

sv_ast_unsetup() 

perror(  "simvads_stop :  sv_restart") 


int  simvads_start 

printf("%s  dummy  simvad.Nn",  vc->s_name) 
sprintf(errbuf,  "simvads_start:error  installing  %s  at  Ox%x",  vc- 
>s_name,  vc->s_address) 
perror(errbuf) 

printf("%s  found  at  Ox%x.\n",  vc->s_naroe,  vc->s_address) 
sprintf(errbuf,  "simvads_start:can't  open  %s",  vc->s_name) 
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peiTor(errbuf) 

fprintf(stderr,  "%s  (desc  =  %d)",  vc->s_name,  vc->s_desc) 
perror(  "simvads_start:sv_restart" ) 
fflush  (stdout) 

Return:  (-1) 

Call:  printf("simvads_start;no  simvads  found  -  can't  init  asts\n") 

Return:  (-1) 

Call:  fflush  (stdout) 

Return:  (0) 


Function  Definition:  int  simvads_restart 
Calls:  simvads_stop() 

simvads_start() 


Function  Definition:  simvads_statistics 

Calls:  Rprintf("%s:\n",  vc->s_name) 

Rprintf("\tIO  errors\t%d\n",  simstats[i].IO_errors) 
Rprintf("\tTicks  with  a  particular  number  of  frames:\n") 
Rprintf("\t  frames") 

Rprintf("\t%d",  j) 

Rprintf("\n") 

Rprintf("\t  ticks(rcvd)") 

Rprintf('\t%d",  simstats[i].frames_rcvd_per_ticklj]) 
Rprintf("\n") 

Rprintf("\t  ticks(sent)") 

Rprintf("\t%d",  simstats[i].frames_sent_per_ticklj]) 
RprintfCNn") 

Rprintf("\texcess  frames 

dropped\t%d\n",simstats[i].excess_output_dropped) 
Rprintf("Vduplicate,d  output 

frames\t%d\n",simstats[i].duplicated_output) 
Rprintf("\xoutput  FiFO 

overflowV%d\n",simstats[i].output_fifo_overflow) 


Function  Definition:  simvads_zero_statistics 


4.1  18.2  Simvads  CSU  Design 

Simvads  consists  of  a  set  of  polling  routines  called  by  the  main  simulation  every  26 
milliseconds,  an  initialization  routine,  and  a  reset  function. 


4.1.19  State  CSU 

The  state  CSU  is  a  set  of  functions  that  maintain  and  report  the  state  of  individual 
simulated  radios. 
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4.1.19.1  State  CSU  Design  Speciti^4  ,on/Constraints 
Function  Definition:  InitializeGlobalState 


Function  Definition:  SetTunerFrequency 
Arguments:  (rp,  frequency,  cue) 

Calls:  BlockHandler("SetTunerFrequency") 

SendTransmitterPDU  (rp,  1) 
UnblockHandler("SetTunerFrequency") 


Function  Definition:  SetTunerHopInfo 
Arguments:  (rp,  hopinfo) 

Calls:  BlockHandlerC'SetTunerHopInfo") 

SendTransmitterPDU  (rp,  1) 
UnblockHandlerC’SetTunerHopInfo") 


Function  Definition:  SetTransmitPower 
Arguments:  (rp,  sw) 

Calls:  BlockHandlerC'SetTransmitPower”) 

UnblockHandler(  "S  etTransmi  tPo  wer" ) 


Function  Definition:  AgeStates 

Calls:  BlockHandlerC'AgeStates") 

UnblockHandlerC'AgeStates") 

BlockHandler("Agc:>tates2") 

UnblockHandler("AgeStates2") 

BlockHandler("AgeStates3") 

UnblockHandler("AgeStates3’’) 


Function  Definition:  VehicleDeactivated 
Arguments:  (vidx) 

Calls:  fprintf(astStream,  'Vehicle  %s 

deactivated.Nn",  VehicleIDToString(vehicleID)) 
fprintf(astStream,  'Radio  Cod  detached  from  vehicle  %d.\n",i, 

vehiclelD) 


Function  Dv  fiintioii:  EickU  an  filer 
Arguments:  (caller) 

Call:  sv_get_astpri() 


Function  Definition:  UnblockHandler 
Arguments:  (caller) 

Call:  sc_unlock() 


4.1.19.2  State  CSU  Design 

State  includes  an  initialization  function  and  functions  invoked  each  time  a  front  panel 
changes  state,  for  example  in  tuning,  transmit  power,  or  transmit  mode. 
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4.1.20  Tables  CSU 

The  tables  CSU  consists  of  functions  used  by  the  keyboard  interface  on  the  console. 


4.1.20.1  Tables  CSU  Design  Specification/Constraints 


tables 

Function  Definition: 
Arguments: 
Calls: 


Function  Definition: 
Call: 


Function  Definition: 
Call: 

Function  Definition: 
Call: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 


voicechannel_display 
(argc,  argv) 

RprintfC'bad  voice  channel  numberXn") 

Rprintf("Voice  Channel  %d:\n",  argv[0]) 

RprintfCVXtname  =  %s\n",  vc->s_name) 
Rprintf("\t\taddress  =  0x%4x\n",  vc->s_address) 
Rprintf("\t\thardware  existsVi") 

Rprintf("\t\tin  useVi") 

RprintfCVXtinput  radio  number  %dNn",  vc->s_radio_input  - 
radioTable) 

RprintfCVNtvehicle  number  %d  crew  station  %d\n",vc- 
>s_vehicle_input  -  vehicleTable,  vc->s_crew_station) 
RprintfCVXtencoding  =  %d\n",  vc->s_encoding) 
RprintfCVXtduration  =  %dSn",  vc->s_duration) 
RprintfCVXtbitcount  =  %dNn",  vc->s_bitcount): 

tickcount_display 

RprintfC’elapsed  ticks  =  %ldSn",  tickCount); 
help 

RprintfC'try  V’A"  for  help\n"); 
version 

RprintfC'Radio  Simulator  Version  =  %s\n",  radio_version); 

DEHNE.TABLE 

(network_histogram_table) 

KEYWORD.SELECT 
("Network  Histogram  Commands") 

KEYWORD 

("show","-  show  PDU  histogram") 

CALL 

(network_histogram_show) 

KEYWORD 

("zero","-  zero  PDU  histogram") 

CALL 

(network_histogram_zero) 
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Function  Definition; 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition; 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments; 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition; 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition; 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments; 

Function  Definition; 
Arguments: 

Function  Definition: 
Arguments; 


DEHNE.TABLE 

(network_table) 

KEYWORD_SELECT 
("Network  Commands") 

KEYWORD 

("getstats","-  show  cmc  statistics") 

CALL 

(network_show_cmcstats) 

KEYWORD 

("zerostats","-  zero  cmc  statistics") 

CALL 

(network_zero_cmcstats) 

KEYWORD 

("ethemetaddress","-  display  ethemet  address") 
CALL 

(network_geteaddr) 

KEYWORD 

("histogram","-  network  histogram  commands") 

DO_KEYWORD_TABLE 

(network_histogram_table) 

DEHNE.TABLE 

(timing_table) 

KEYWORD.SELECT 
("Timing  Commands") 

KEYWORD 

("show","-  show  timing  data") 

CALL 

(timing_display) 

KEYWORD 

("zero","-  zero  timing  data") 

CALL 

(timing_zero) 

DEHNE.TABLE 

(simulation_table) 

KEYWORD_SELECT 
("Simulation  Commands") 
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Function  Definition: 

KEYWORD 

Arguments: 

("tickcount","-  show  tickcount") 

Function  Definition: 

CALL 

Arguments: 

(tickcount_display) 

Function  Definition: 

KEYWORD 

Arguments: 

("voicechannel","-  show  voice  channel  data") 

Function  Definition: 

GETDECIMAL 

Arguments: 

("channel") 

Function  Definition: 

CALL 

Arguments: 

(voicechannel_display) 

Function  Definition: 

DEHNE.TABLE 

Arguments: 

(hardware_table) 

Function  Definition: 

KEYWORD.SELECT 

Arguments: 

("Hardware  Commands") 

Function  Definition: 

KEYWORD 

Arguments: 

("resetsimvads","-  reset  ALL  siitivad  cards") 

Function  Definition: 

CALL 

Arguments: 

(simvads_restart) 

Function  Definition: 

KEYWORD 

Arguments: 

("simstats","-  show  statistics  for  simvads") 

Function  Definition: 

CALL 

Arguments: 

(simvads_statistics) 

Function  Definition: 

KEYWORD 

Arguments: 

("resetfrontpanels","-  reset  ALL  front  panels") 

Function  Definition: 

CALL 

Arguments: 

(reset_fp) 

Function  Definition: 

DEHNE.TABLE 

Arguments: 

(riu_table) 

Function  Definition: 

KEYWORD_SELECT 

Arguments: 

("RIU  Commands") 

Function  Definition: 

KEYWORD 

Arguments: 

("show","-  show  RIU  statistics") 

Function  Definition: 

GETDECIMAL 

Arguments: 

("riu  index") 

Function  Definition: 

CALL 

Arguments: 

(riu_statistics) 
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Funcuon  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 

Function  Definition: 
Arguments: 


KEYWORD 

("zerostats","-  zero  RIU  statistics") 

CALL 

(riu  .zero_statistics) 

DEFINE_TABLE 

(fp_table) 

KEYWORD_SELECT 
("Fiuiit  Panel  Commands") 

KEYWORD 

("show","-  show  front  panel  state") 

GETDECIMAL 
("front  panel  index") 

CALL 

(fp_show) 

KEYWORD 

("set","-  set  front  panel  parameter") 

GETDECIMAL 
("front  panel  index") 

GETSTRING 

("switch") 

GETSTRING( 

"setting") 

CALL 

(fp_set) 

DEHNE.TABLE 

(simvads_table) 

KEYWORD_SELECT 
("SIMVADs  Commands") 

KEYWORDC'show","-  show  simvad  statistics") 

CALL 

(simvads_statistics) 

KEYWORD 

("zero","-  zero  simvad  statistics") 

CALL 

(simvad  s_zero_stati  stic  s) 


©1991  Bolt  Beranek  and  Newman  Inc. 


77 


BBN  Report  No.  7632 


BBN  Systems  and  Technologies 


Function  Definition: 

DEFINE.TABLE 

Arguments: 

(command_table) 

Function  Definition: 

KEYWORD_SELECT 

Arguments: 

("Commands") 

Function  Definition: 

KEYWORD 

Arguments: 

("network","-  network  functions") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(network_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("simulation","-  simulation  status") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(simulation_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("timing","-  timing  functions") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(timing_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("riu","-  RIU  functions") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(riu_table) 

Function  Definition: 

KEYWORD 

Arguments: 

C'fp","-  front  panel  functions") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(fp_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("simvads","-  simvads  functions") 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(simvads_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("hardware","-  hardware  functions"^ 

Function  Definition: 

DO_KEYWORD_TABLE 

Arguments: 

(hardware_table) 

Function  Definition: 

KEYWORD 

Arguments: 

("help","-  parser  editor  help") 

Function  Definition: 

CALL 

Arguments: 

(help) 
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Function  Definition:  KEYWORD 

Arguments:  ("version","-  print  simulator  version  information") 

Function  Definition:  CALL 
Arguments:  (version) 

Function  Definition:  KEYWORD 

Arguments:  ("exit","-  exit  program") 

Function  Definition:  CALL 

Arguments:  (exit_gracefully) 


4.1.20.2  Tables  CSU  Design 

Tables  functions  are  invoked  by  the  main  loop  in  main.c  via  the  function  ttyjick. 


4.1.21  Timing  CSU 

The  timing  CSU  functions  do  simulation  performance  timing,  including  recording  and 
reporting  performance. 


4.1.21.1  Timing  CSU  Design  Specification/Constraints 

Function  Definition:  timing_start 
Arguments:  (which) 

Call:  net_current_time(network_get_descriptor()); 

Function  Definition:  timing_end 
Arguments:  (which) 

Call:  net_current_time(network_get_descriptor()); 

Function  Definition:  timing_display 
Calls:  Rprintf("\n"); 

RprintfC  %-40s%-10s%-10s%-10s  (ms)\n", "", "  min", "  ave", 
"  max"); 

BlockHandler("timing_display"); 

UnblockHandler("timing_display"); 

RprintfC  %-40s  %-9.1f  %-9.1f  %-9.1f\n",  ptv- 

>string,(float)tmin,(float)tsum  /  NUMSAVED,(float)tmax); 
Rprintf("Inter-AST  Interval  HistogramNn"); 

Rprintf("0\t  I\t2\t3-4\t5-8\t9-l  6\t>  1 6\n"); 
Rprintf("%d\t%cFl%d\t%dM%d\t%d\t%d\n", 

inter_ast_histogram[0],inter_ast_histogram[l], 

inter_ast_histogram[2],inter_ast_liistogram[3], 

inter_ast_histogram[4],inter_ast_histogram[5], 

inter_ast_histogram[6]); 

Function  Definition:  timing_inter_ast 
Arguments:  (now) 

Function  Definition:  timing_zero 
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Function  Definition:  timing_init 
Call:  timing_zero(); 

Function  Definition:  timing_uninit 

4.1.21.2  Timing  CSU  Design 

Timing  functions  are  invoked  from  tables.c,  main.c,  network. c,  simvads.c,  and  panelint.c. 

4.1.22  Version  CSU 

The  version  CSU  is  a  timestamp,  reflecting  when  the  current  version  of  the  software  was 
assembled. 

4.1.22.1  Version  CSU  Design  Specification/Constraints 

The  file  Version  contains  no  function  definitions. 

4.1.22.2  Version  CSU  Design 
Not  applicable. 

4.1.23  Vinfo  CSU 

The  vinfo  CSU  is  a  set  of  data  structures  describing  the  vehicles  with  which  radios  are 
associated. 

4.1.23.1  Vinfo  CSU  Design  Specification/Constraints 
The  file  Vinfo  contains  no  function  definitions. 

4.1.23.2  Vinfo  CSU  Design 

Vinfo  contains  no  code,  only  data  structure  allocations.  It  is  referenced  in  network.c. 

5  CSCI DATA 

Data  .c  contains  the  radio  tables,  front  panel  tables,  and  riu  tables. 

6  CSCI  DATA  FILES 

There  are  no  shared  data  files.  The  simulator  reads  its  parameter  file  (discussed  in  4. 1 . 1 1 ) 
at  start  up  time.  It  also  looks  to  files  for  descriptions  of  the  noise  made  when  data  is 
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transmitted  (/simnet/data/sincgars/busy)  and  when  squelch  is  disabled 
(/simnet/data/sincgars/noise). 


6.1  DATA  FILE  TO  CSC/CSU  CROSS  REFERENCE 

This  paragraph  provides  a  mapping  of  each  data  file  identified  below  to  the  CSCs  and 
CSUs  that  use  the  data  file. 


6.2  NAME  DATA  FILE 
Not  applicable. 


7  REQUIREMENTS  TRACEABILITY 
Not  applicable. 

8  NOTES 


8.1  Acronyms/Abbreviations 

CSC  Computer  Software  Component 

CSCI  Computer  Software  Configuration  Item 

CSU  Computer  Software  Unit 

CDR  Critical  Design  Review 

Cl  Configuration  Item 

FCA  Functional  Configuration  Audit 

IDD  Interface  Design  Document 

NDS  Non-Developmental  Software 

PCA  Physical  Configuration  Audit 

PDR  Preliminary  Design  Review 

SDD  Software  Design  Document 

SRS  Software  Requirements  Specification 


8.2  Notation 
Not  applicable. 
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